Capitolo I 

Introduzione 



Benvenuti 

Vi auguriamo una piacevole lettura del manuale PHP, il libro che insegnerà a creare 
siti Web dinamici, che interagiscano con gli utenti, e renderà possibile lo sviluppo 
di applicazioni Web complesse. 

Informazioni su PHP 

PHP (PHP Hypertext Pre-processor) è un linguaggio di scripting che viene incorpo- 
rato nell'HTML (Hypertext Markup Languagé), L'obiettivo del linguaggio è consen- 
tire la costruzione rapida e semplice di pagine Web dinamiche. PHP funziona insie- 
me a un server Web e può essere utilizzato con moltissimi sistemi operativi, tra cui 
Microsoft Windows e UNIX. 

PHP è diverso dagli altri script CGI (Common Gateway Interface), scritti in linguaggi 
come Perl o C, poiché questi richiedono all'utente di creare programmi separati che 
producono codice HTML. PHP invece è incorporato nel documento HTML con spe- 
ciali tag iniziali e finali che permettono di entrare e uscire da esso. In questo modo, 
l'utente finale può visualizzare rapidamente le pagine e contare su un'elevata prote- 
zione e trasparenza. Con PHP potete fare tutto quello che otterreste scrivendo ap- 
plicazioni CGI separate, vale a dire creare pagine Web dinamiche, elaborare moduli 
e gestire file. 

La sintassi di PHP è simile a quella dei linguaggi di programmazione C, C++ e Java. 
Per chi ha una certa dimestichezza con questi linguaggi. PHP sembrerà un linguag- 
gio molto familiare. Chi invece non ha alcuna esperienza di tali linguaggi non deve 
preoccuparsi, poiché PHP è molto semplice da comprendere. 
Una tra le caratteristiche più importanti ed efficaci di PHP è la sua capacità di inter- 
facciali con una vasta gamma di database. Al momento senio supportati più di ven- 
ti database diversi, consentendo agli sviluppatori PHP di creare agevolmente pagine 
Web in grado di interagire con database. Più avanti vedrete come utilizzare il data- 
base MySQL. 



Questo libro fa al caso vostro? 



Nella realizzazione di questo manuale si è cercato di concentrarsi su un tipo di 
Utente target. Se siete: 

1 . ingegneri del software professionisti, desiderosi di applicare le vostre capa- 
cità di sviluppatori alla creazione di applicazioni Web; 

2. sviluppatori professionisti di siti Web, desiderosi di imparare a creare appli- 
cazioni Web dinamiche più potenti con PHP; 

3i sviluppatori intranet che lavorano per una società che vuole espandere le 
proprie applicazioni di rete servendosi di una tecnologia Web dinamica; 

i. neolaureti che devono imparare a programmare con PHP in breve tempo; 

5. studenti iscritti a un corso pre-laurea o post-laurea cui viene chiesto di svi- 
luppare un sistema Web dinamico come parte integrante di un progetto; 
' [Uesto libro fa al caso vostro. 

Requisiti indispensabili... 

Partiamo dal presupposto che: 

1. sappiate utilizzare molto bene un computer Microsoft Windows o UNIX; 

2. sappiate realizzare pagine Web con HTML; 

3. abbiate una certa dimestichezza con linguaggi di scripting come Javascript; 

4. magari una discreta esperienza di programmazione con linguaggi quali C. 
Visual Basic, Java o COBOL. 

Se possedete i requisiti appena elencati, questo manuale è stato scritto per voi. 

Utilizzo del manuale 

Questo manuale è stato scritto per essere letto dall'inizio alla fine. Gli ultimi capitoli 
si basano sulle conoscenze e gli spunti introdotti nei primi. Dopo aver letto il libro, 
potrete fare riferimento ai singoli capitoli qualora voleste rinfrescarvi la memoria su 
un particolare aspetto di PHP. 

Struttura del manuale 

Il libro è suddiviso in capitoli che trattano aspetti specifici del linguaggio PHP. I ca- 
pitoli sono raggruppati a loro volta in parti che fanno riferimento ad ambiti più ge- 
nerici del linguaggio. 

La l'arte 1 introduce il linguaggio PHP, spiega in che modo configurare un ambiente 
ili sviluppo e presenta i primi script PHP. 

• Il Capitolo 2 fornisce un'introduzione e una descrizione sommaria di PHP. 

• Il Capitolo 3 spiega come creare un ambiente di sviluppo PHP e mostra 
dove trovare aiuto e assistenza. 



• il i lapitolo 4 Introduce il primo programma PHP. 

• Il Capitolo 5 si occupa dei principi basilari di PHP. 

I ,i Parte 2 introduce le istruzioni, le variabili e le espressioni di base del linguaggio 

PHP. 

• Il ( Capitolo 6 presenta le variabili e i tipi di PHP. 

• Il ( lapitolo 7 analizza i tipi booleani, interi e in virgola mobile. 

• Il Capitolo 8 presenta il tipo stringa. 

• Il Capitolo 9 chiarisce il concetto di variabili PHP predefinite e spiega come 
valutarle. 

• Il Capitolo 10 tratta le espressioni, gli operandi e gli operatori. 

• Il Capitolo 11 illustra le istmzioni if e switch e mostra come si possano 
utilizzare gli operatori condizionali e booleani all'interno di tali istruzioni. 

. 1 1 Capitolo 12 descrive i vari cicli utilizzabili con PHP. 

• Il Capitolo 13 analizza i concetti di scomposizione funzionale, creazione di 
funzioni e file inclusi. 

• Il Capitolo 14 illustra il concetto di array. 

. Il Capitolo 15 introduce le date, le ore e i numeri casuali e spiega come ac- 
cedervi. 

Parte 3 esamina come manipolare le stringhe e gli array con numerose funzioni 
PHP standard. 

• Il Capitolo 16 si occupa della manipolazione degli array. 

• Il Capitolo 17 analizza la manipolazione delle stringhe. 

l'arte 4 introduce il concetto di interazione con l'utente e spiega come gli utenti 
ino interagire con le applicazioni PHP tramite i moduli. 

• Il Capitolo 18 spiega come gli script possano interagire con l'utente. 

Il Capitolo 19 descrive la convalida dei dati dei moduli e la conservazione 
dei dati. 

• Il Capitolo 20 tratta i problemi legati alla protezione dei dati dei moduli. 

• Il Capitolo 21 spiega come usare PHP per inviare messaggi di posta elettro- 
nica agli utenti. 

I .i l'arte 5 descrive due metodi che permettono di conservare i dati nel passaggio da 
pagina Web all'altra, vale a dire cookie e sessioni./ 

• Il Capitolo 22 presenta i cookie. 

• Il Capitolo 23 descrive le sessioni e la gestione delle sessioni. 

I ,i Parte 6 analizza in che modo gli script possano gestire gli errori e mostra come 
i lufferizzare l'output sulle pagine Web e regolare il contenuto del buffer. 

• Il Capitolo 24 analizza la gestione degli errori. 

• Il Capitolo 25 spiega come bufferizzare e modificare l'output delle pagine 
Web. 

i i Parte 7 espone il concetto di gestione dei file. 

• Il Capitolo 26 descrive come leggere e scrivere dati su file. 

• Il Capitolo 27 analizza in dettaglio altre operazioni che è possibile eseguire 
con i file. 

• Il Capitolo 28 spiega come . arie are i file su un server tramite I moduli. 



La l'arie H Introduce il concetto eli manipolazione; grafica. 

• Il Capitolo 2'» analizza esempi eli manipolazione grafica semplice. 

• Il Capitolo 30 introduce la libreria GD e illustra come utilizzarla per creare 
in modo dinamico nuove immagini. 

• Il Capitolo 31 illustra come utilizzare la libreria GD per creare un'utile appli- 
cazione per la generazione di grafici. 

l i l'arte 9 analizza il concetto di creazione di documenti diversi dalle pagine Web 
attraverso l'estensione della libreria PDF. 

• Il Capitolo 32 si occupa della creazione di documenti PDF. 

La Parte 10 esamina il concetto di collegamento di un database a un sito Web con il 
sistema di gestione database MySQL. 

• Il Capitolo 33 offre un'introduzione alla progettazione di tabelle di database. 

• Il Capitolo 3/4 spiega come installare il database MySQL e PHPmyadmin. 

• Il Capitolo 35 spiega come configurare il database MySQL. 

• Il Capitolo 36 descrive come utilizzare PHP per interfacciarlo a un database 
MySQL. 

l.a Parte 11 descrive il paradigma a oggetti e spiega come usare PHP per creare ap- 
plicazioni a oggetti. 

o II Capitolo 37 presenta i concetti di classi e oggetti, caratteristici del paradig- 
ma a oggetti. 

• Il Capitolo 38 prosegue con l'analisi dell'orientamento agli oggetti aggiun- 
gendo un'analisi dell'ereditarietà delle classi. 

Infine, la Pane 12 descrive un'applicazione di e-commerce realizzata mettendo in 
pratica tutti i concetti presentati nei capitoli precedenti del manuale. 

• Il Capitolo 39 descrive il sistema di e-commerce front-end. 

• Il Capitolo 40 descrive il sistema di amministrazione del sito di e-commerce. 

Script PHP 

Questo libro contiene numerosi script d'esempio; tutti gli script sono stati verificati 
con l'ultima versione dell'ambiente PHP. Tali script possono essere prelevati dal sito 
Web dedicato al manuale, www.phpmysql-manual.com, risparmiandovi la fatica di 
inserirli. Si deve ammettere, però, che molto spesso si impara di più digitando ma- 
nualmente gli script degli esempi, quindi potete tranquillamente scegliere di adotta- 
re questa tecnica. 

Partenza... 

Non rimane molto altro da dire se non invitarvi a girare la pagina e procedere con il 
prossimo capitolo. 



Capitolo 2 

Introduzione a PHP 



Introduzione 

In questo capitolo presenteremo PHP, descrivendo che cos'è, la sua storia e la sua 
popolarità. Iniziamo analizzando la vera natura di PHP. 

Che cos'è PHP? 

"PHP (acronimo ricorsivo di PHP Hypertext Preprocessor) è un linguaggio di scrip- 
ting open-source per la realizzazione eli pagine Web dinamiche, applicazioni di e- 
commerce e altre applicazioni Web" (definizione tradotta eia www.zend.com/ 
zend/aboutphp.php). Le pagine Web dinamiche sono quelle che non rimangono 
inalterate, ma interagiscono con l'utente permettendogli di vivere un'esperienza 
Web più ricca e interessante. T sistemi Web dinamici sono utilizzati soprattutto nei 
sistemi di commercio elettronico che interagiscono con i database, dando agli utenti 
la possibilità di selezionare ed acquistare online vari prodotti. 
PHP è disponibile gratuitamente al silo www.php.net e costituisce una soluzione 
semplice ma potente per sviluppare sistemi Web dinamici. PHP è incorporato nelle 
pagine HTML, e ciò consente di inserire le istruzioni di script esattamente nel punto 
in cui sono necessarie. 

PHP è ampiamente supportato da una vasta comunità online ed è un prodotto 
open-source. Tale comunità offre un supporto straordinario agli sviluppatori e qual- 
siasi errore viene individuato e risolto in breve tempo, poiché il nucleo fondamen- 
tale del codice PHP viene costantemente migliorato e aggiornato. 
PHP presenta un'eccellente connettività con un gran numero di database (per 
esempio Oracle e MySQL), nonché l'integrazione con numerose librerie esterne che 
permettono al linguaggio di generare, per esempio, immagini grafiche e documenti 
PDF. 

Infine PHP è indipendente dalla piattaforma, in quanto viene eseguito senza alcun 
problema su piattaforme sia Winelews sia UNIX. 



Storia di PHP 



La storia di PHP risale al 1995. Da allora, modifiche e migliorie significative hanno 
portato al rilascio della versione 5-0 di PHP nel giugno 2003. La Tabella 2.1 è un 
adattamento delle informazioni disponibili all'indirizzo www.php.net/manual/en/ 
history.php e descrive le release più importanti di questo linguaggio dall'anno 
elei suo concepimento. 



Tabellari 



Storia di PHP 



Versione 



PHP/FI 
Data; 1995 



PHP/FI 2.0 
Data: 1997 
PHP 3.0 
Data: 1997 



PI IP 4 

Dala: 1999 



PHP 5 
Data: 2003 



Descrizione 



Nel 1995 Rasmus Lerdorf creò un insieme di script Perl per tenere trac- 
cia degli accessi al suo sistema Web. All'inizio, questi script erano noti 
con il nome di -Personal Home Page Tools". Gli script originali sono 
stati riscritti con il linguaggio di programmazione C e sono stati mi- 
gliorati con l'aggiunta di funzionalità superiori. Per esempio, la comu- 
nicazione con il database e la possibilità di sviluppare semplici appli- 
cazioni Web. Questa versione è nota con il nome di Personal Home 
Page/Formslntetpretereà è stata messa a disposizione del pubblico. 
Nel novembre 1997 venne rilasciato ufficialmente PHP/FI 2.0. Allora 
50.000 domini annunciarono di aver installato questo software. 
PHP 3.0 è la prima versione di PHP che può essere considerati simile a quella 
odierna. Venne creata da Andi Gutmans e Zeev Suraki come riscrittura di 
PHP/FI 2.0 per un progetto di e-commerce di un'università. Andi Gutmans e 
Zeev Suraki decisero di collaborare con Rasmus Lerdorf e annunciarono PHP 
3.0 come successore ufficiale di PHP/FI 2.0. 

Le caratteristiche chiave di PHP 3.0 erano la straordinaria estensibilità 
la connettività a database e il supporto per il paradigma a oggetti. 
Il linguaggio PHP 3.0 venne rilasciato con il nuovo nome PHP che è 
l'acronimo ricorsivo di PHP Hypertext Preprocessor. 
Entro la fine del 1998 PHP 3.0 era installato su circa il 10% dei server 
Web presenti su Internet. 

Nell'inverno del 1998, Andi Gutmans e Zeev Suraki iniziarono a riscri- 
vere il nucleo fondamentale di PHP per migliorare le prestazioni delle 
applicazioni più complesse. Il nuovo motore principale prese il nome 
di 'Zend Engine" come derivazione dai nomi dei due autori "Zeev e 
Andi". 

Rilasciato in versione beta a metà del 2003, PHP 5.0 è la release più re- 
cente del linguaggio, e ha come nucleo fondamentale il nuovo Zend 
Engine 2.0. 



Quanto è diffuso PHP? 



La diffusione di PHP è grande e in costante crescita. Spesso è difficile stabilire con 
precisione il grado di notorietà di un linguaggio di programmazione, poiché esisto- 
no molti modi diversi per effettuare una stima. Tuttavia, il sondaggio di Netcraft for- 
nisce un calcolo del numero di indirizzi di provider Internet e di domini che utiliz- 
zano PHP. La Figura 2.1 mostra le ultime statistiche del sondaggio Netcraft 
(www.php.net/usage.php), che illustrano chiaramente la crescita dell'uso di PHP 
dal gennaio 1999. 

I In'altra misurazione, il TPCI (TIOBE Programming Community Index), dà un'indi- 
cazione della popolarità dei linguaggi di programmazione. A luglio del 2003 PHP 
aveva raggitmlo la sesia posizione tra i linguaggi più noti attualmente in uso, eoo» 
mostrato nel grafico della figura 2.2. 
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Figura 2. 1 

I sondaggio di Netcraft. 
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Figura 2.2 

TPCI. Popolarità dei linguaggi di programmazione. 




Server Web e CGI 

Uno dei problemi maggll iri C( in I di iCUmenti HTML è legato alla loro staticità: infatti 
tali documenti visualizzai» 1 sempre il medesimo contenuto ogni volta che vi si acce- 
de. La Figura 2.3 mostro Un MtVOi Web tradizionale che riceve una richiesta relativa 

a una pagina Web spc< ih. .. <• pana tale rii hi. m i .il browser Web. i.e pagine Web 



dinamiche sono invece pagine Web il cui contenuto viene prodotto automatica? 
mente da un programma ogni volta che vi si accede. 



Browser Web [e] 



1 . Richiede una pagina 
HTML 



Browser Web [e] 



3. Fornisce la pagina HTML 



Server Web 



2. Individua 
la pagina HTML 



Figura 2.3 

Passaggio di una pagina HTML. 



Agli albori del Web fece la sua comparsa uno standard ideato proprio per la realizza- 
zione di questi programmi. Tale standard, noto con il nome di Common Gateway In- 
terface (i programmi conformi allo standard spesso prendono il nome di script CGD 
specifica in che modo un server Web passa i dati a un programma in esecuzione. ' 
c h £l lpl CGI P° sàono essere scritti con una vasta gamma di linguaggi, come Perl, 

1 \_iJj C COSI V13 . 

Figura" e 4 fun2Ìonano gH SCripl CGI? Prend ™' in considerazione il diagramma della 



Browser Web [e] 



1 . Richiede un'applicazione 
CGI 



Browser Web [e] 



4. Fornisce la pagina HTML 



Server Web 



2. Esegue 
l'applicazione CGI 



3. Genera 

la pagina HTML 



Programma 

eseguibile 

CGI 



Figura 2.4 

Creazione di una pagina Web dinamica con CGI. 



In questo caso, l'elaborazione CGI inizia nel momento in cui un browser richiede un 
documento (nell'esempio si tratta di un'applicazione CGI) a un server Web. Al brow- 
ser non importa se la pagina richiesta è un documento HTML statico o uno script CGI, 
poiché si limita a inviare la richiesta al server Web. 

Quest'ultimo riconosce la richiesta di uno script CGI ed esegue l'applicazione CGI 
specifica. Lo script CGI fornisce codice HTML standard. Questo risultato viene pas- 
sato al browser in modo da essere visualizzato sotto forma di pagina Web. 
Il problema principale delle applicazioni CGI è che le istruzioni HTML che control- 
lano il formato delle informazioni dinamiche prodotte dalle applicazioni tendono a 
disperdersi nel codice del programma. Questo complica la produzione di pagine- 
Web dinamiche che possano risultare interessanti e di semplice fruizione, oltre a in- 
fluire sulla manutenzione. 



Funzionamento di PHP 

L'approccio PFIP alle pagine Web dinamiche differisce per un aspetto molto impor- 
tante: invece di avere i tag HTML incorporati nel codice del programma, uno script 
PHP incorpora il codice del programma in HTML. La Figura 2.5 mostra il funziona- 
mento di uno script PHP. 



Browser Web e 



1. Richiede uno script PHP 



Browser Web 6 



5. Fornisce la pagina HTML 



Server Web 



2. Individua 
lo script PHP 



4. Genera 
la pagina 
HTML 



Parser PHP 



3. Analizza lo script PHP 



Figura 2.5 

Creazione di una pagina Web dinamica con PHP. 



Dalla Figura 2.5 potete vedere che quando un browser richiede uno script PHP, il 
server Web esegue il parser PHP e passa a tale interprete qualunque dato fornito 
dal browser, oltre ovviamente allo script PHP. Lo script PHP viene elaborato dal 
parser, il codice HTML contenuto nello script viene subito ripassato al browser, 
mentre il codice del programma viene eseguito e l'output ottenuto viene inviato al 



b ?^' ser - È ^portante considerare che è il programmatore PHP ad avere la respon- 
sabilità di garantire che il codice PHP fornisca .sintassi HTML valida, poiché in caso 
contrario il browser non potrà visualizzarla correttamente. 



Riepilogo 

[n questo capitolo abbiamo introdotto il linguaggio PHP e descritto la storia del suo 
sviluppo. Abbiamo mostrato che PHP è ampiamente utilizzato e che il suo impiego 
e ancora in una fase di crescita. Nei prossimo capitolo vedremo come e dove è pos- 
sale procurarsi una copia di PHP e quali siano le applicazioni associate necessarie 
per creaie il proprio ambiente di sviluppo PHP. 



Capitolo 3 

Installazione dell'ambiente, 
aiuto e assistenza 



Introduzione 

Questo capitolo illustra dove è possibile reperire il software necessario per creare 
il proprio ambiente di sviluppo PHP. Se il provider di servizio o l'amministratore 
Web ha già installato un server Web, PHP e le applicazioni associate, potete salta- 
re la prima parte del capitolo. Il paragrafo che non conviene ignorare è invece 
quello che spiega dove è possibile trovare aiuto se si incorre in qualche problema 
nella creazione di applicazioni PHP. Si vedrà dove e come accedere al manuale di 
l'I IP e verranno presentate altre risorse online che lo sviluppatore PHP dovrebbe 
tenere presenti. 

Software necessario 

Per iniziare a sviluppare applicazioni PHP avrete bisogno del software seguente: 

• un browser Web; 

• un server Web; 

• PHP; 

. un editor di testo; 

• un database. 

la base al sistema operativo disponibile, ai gusti personali ed eventualmente ai re- 
i |uisiti organizzativi, esistono diverse possibilità per ciascuna di queste applicazioni. 
Analizziamone una alla volta. 

Browser Web 

Il browser Web è l'applicazione utilizzata per visualizzare l'output dagli script 
I l'I MI. l'i II'. I due browser più comuni sono Microsoft Internet Explorer e Netscape. 
Per gli nienti Microsoli Windows il più facile da ottenere è Internet Explorer, in quan- 
to è incluso come parte integrante nel sistema operativo Windows. Anche Netscape è 
un browser conosciuto, soprattutto dagli utenti UNIX. Entrambi i browser sono co- 
siantemente aggiornali e migliorati, Potete procurarvi l'uliima versione di Iniernet 



Explorer al sito www.microsoft.com/windows/ie/ e di Netscape dall'indirizzo ho- 
me.netscape.com/it/download/. 

ServerWeb 

il secondo elemento software necessario è un server Web. Un server Web riceve le 
richieste di documenti Web provenienti dai client Web (i browser), ottiene i docu- 
menti richiesti e li passa al browser Web affinché vengano visualizzati. Benché pos- 
siate sviluppare script HTML in un computer indipendente privo di server Web 
questo non è possibile se desiderate utilizzare PHP. 

I server Web disponibili per i vari sistemi operativi sono molti; alcuni sono prodotti 
commerciali potenti e costosi, mentre altri sono gratuiti, pur essendo prodotti di alta 
qualità sviluppati a livello professionale. 

Ì%Ì! ? ?' e ™ UNIX ? M1sl '8 liarao « server Web Apache, disponibile ali "indirizzo 
nttp // httpd.apache.org/download.cgi. Per le piattaforme Windows o Mi- 
crosoft raccomandiamo il server Internet Information Services, incluso in Win- 
dows XP e Windows 2000, ma prelevabile anche dalla pagina www. micro- 
soft . com/downloads/. Consigliamo inoltre Appserv, disponibile all'indirizzo 
http: //appserv.sourcef orge .net/. 

Dato che ciascun server è diverso, dovrete leggere e seguire le istruzioni di instal- 
lazione per ogni singolo prodotto. 

PHP 

Per visualizzare correttamente gli script PHP dovrete procurarvi una copia di PHP 
dal suo www. php. net. Dovrete scaricare la versione corretta di PHP per il vostro si- 
stema operativo e configurare PHP e il server Web in modo che funzionino insie- 
me. La maggior parte dei server Web fornisce le istruzioni necessarie in merito Tut- 

SSKSE* e continuate a ,e8gere ' poiché tra poco sarà proposca una 

Editor di testo 

Per cominciare a creare script HTML e PHP è necessario disporre di un editor di 
lesto per modificare gli script. Qualunque editor di testo va bene e, natu ral niente 
ognuno ha le proprie preferenze. Emacs e vi sono particolarmente adatti per gli 
utenti LNIX, mentre Windows fornisce Blocco note, un editor di testo molto sem- 
plice ma non altrettanto potente. Per tutti gii esempi del libro abbiamo usato Bloc- 
co note, tuttavia potete senza alcun problema utilizzare un editor di testo che co- 
noscete meglio. 

Database - MySQL 

L'ultimo componente necessario è un database. PHP interagisce con molti database 
diversi (per l'elenco completo fate riferimento alla documentazione di PHP) min 
via abbiamo deciso di ricorrere al database MySQL poiché è gratuito e moli., pule,, 
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te, MySQL è open source e può essere scaricato da http://www.mysql.com/ sia 
per le piattaforme Unix sia per quelle Windows. 

MySQL ha un'interfaccia utente abbastanza complessa. Tuttavia, come vedremo nel 
prosieguo del libro, la guida è molto comoda grazie allo strumento PHPMyAdmin, 
che consente di configurare in modo rapido e facile i database MySQL. PHPMyAd- 
min è scaricabile da http : / /www. phpmyadmin . net/. 



BundI e software integrati 

I principianti di PHP possono incontrare una certa difficoltà nel districarsi tra tutti i 
software necessari. Come si può essere certi che tutti i componenti software siano 
Installati e funzionino in modo corretto? Fortunatamente il problema è stato affron- 
tino e la soluzione che ne è scaturita è quella del bundle di applicazioni. Per sempli- 
Bcare la vita dei principianti (e di buona parte degli utenti più esperti), le ultime 
versioni di tutto il software necessario per iniziare a sviluppare in PHP sono state 
raggruppate j n un unico pacchetto e sono state configurate per funzionare corretta- 
mente insieme. 

si può scegliere tra una vasta gamma di bundle, molti dei quali sono elencati nel 
sito Web di HotScripts: http://www.hotscripts.com/PHP/Software_and_Ser- 
vers/Installation_Kits/. 

Per gli utenti Windows consigliamo il progetto Appserv Open, che dispone delle 
versioni più recenti del server AppServ e di PHP, MySQL e phpMyAdmin. Potete 
tri >varlo all'indirizzo http : / /appserv . sourcef orge '. net / ed è molto semplice da 
Scaricare e installare. 



Ottenere aiuto e assistenza 

\ l 'rescindere dall'esperienza acquisita con PHP, prima o poi arriverà un momento 
in cuj non saprete come comportarvi e avrete bisogno di aiuto e assistenza. In que- 

itl casi potreste trovare l'aiuto necessario nel manuale di PHP, oppure consultando 
Oltre fonti. Nei prossimi paragrafi del capitolo si vedrà dove conviene rivolgersi per 
i ittenere aiuto e assistenza. 



Leggete il manuale di PHP 

Il manuale di PHP è disponibile online in diverse lingue (anche in italiano). Dalla 
pagina www.php.net/docs.php potete scegliere la lingua preferita e decidere se 
volete visualizzare una documentazione ricca di immagini o una più consona alle 
esigenze di stampa. La Figura 3.1 mostra un esempio del manuale online. 
Chi desidera avere a disposizione una propria copia del libro, per poterlo consulta- 
re anche quando non è disponibile l'accesso a Internet, può scaricare il manuale in 
una vasta gamma di lingue e formati. La Tabella 3-1 elenca i vari tipi di documenti 
che è possibile scaricare. 

Non tutti i formati elencati nella Tabella 3.1 sono disponibili in tutte le lingue. Tra 
unii i manuali scaricatili disponibili, rileniamo particolarmente utile il l'ormato di 
l'ile .ehm della guida di Windows. Il tilt- fornisce un normale l'ile di guida ili Win- 
dows, ehe consente di ceri are le Infonwraioni in modo rapido e .semplice c di vi- 
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II. Funzioni di Array 
Introduzione 



ti 



Queste funzioni permettono di manipolare e interagire con gli array In vari 
modi. Gli array sono indispensabili per immagazzinare, mantenere e operare 
su gruppi di variabili. 

Sono supportati sia array semplici che multi-dimenslonali, che possono essere 
sia creati dall'utente che da funzioni. CI sono specifiche funzioni di database 
per riempire gli array a partire da interrogazioni sui dati, e parecchie funzioni 
restituiscono array. 



Vedere la sezione Array del manuale per una spiegazione dettagliata di come 




Figura 3. 1 

Il manuale PHP consultabile online. 



Tabella 3. 1 Formati di documento scaricabili 



Tipo 



HTML singolo 
HTML multiplo 

PDF 



Palm Pilot DOC 
PalmPilot iSilo 
Windows HTML Help 



Descrizione 



Un unico file HTML molto grande, contenente l'intero manuale. 
Un file tar (compresso) composto da parecchi documenti HTML 
più piccoli, che costituiscono l'intero manuale. 
Il manuale in formato PDF che può essere visualizzato con Adobe 
Acrobat. Questo file può essere installato' su uri palmare, purché sia 
disponibile una versione di Adobe Acrobat Reader per i palmari. 
Un file DOC standard per PalmPilot. 
Un file iSilo standard per PalmPilot. 
Un formato di file .ehm per Windows. 



sualizzarle in un formato facile e comodo da leggere. La Figura 3.2 mostra come si 
presenta il file quando si visualizza l'argomento delle strutture di controllo. 

Manuale di MySQL 

Il database MySQL, che utilizzeremo più avanti per creare applicazioni di database 
dinamiche, ha una documentazione completa, che si può scaricare. Tale documen- 
tazione è disponibile in diversi formati, simili a quelli del manuale di PHP. Le ver- 
sioni scaricabili del manuale di MySQL sono disponibili alla pagina http:// 
dev.mysql.com/doc/, riprodotta nella Figura 3.3. 
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Capitolo 11. Strutture di controllo 

Sommario 

11 

else 

elselt 

Sintassi alternativa orar le strutt ure di controllo 
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break: 
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return 
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Qualsiasi script PHP è costituito da una serie dì istruzioni. Una istruzione 
può essere un'assegnazione, una chiamata di funzione, un loop, una 
istruzione condizionale che non fa nulla (istruzione vuota). Le istruzioni 
terminano con un punto e virgola. Inoltre, le istruzioni si possono 
raggruppare in blocchi di istruzioni racchiudendole tra parentesi graffa. Un 

n.'unnr. rlj jetmvin"' ò a -ri ir, jgplfca 1 «Viel-r. ninno H n'aconfo ranil-nln 



Figura 3.2 

1 Ile della guida di Windows. 
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Figura 3.3 

Pagina dei download di MySQL. 



Manuale della Librerìa GD 



Nei Capitoli 30 e 31 vedrete che PHP può essere utilizzato per creare file di imma- 
gini in modo dinamico sfruttando la libreria di funzioni di terzi nota come Libreria 
GD. Nel libro verranno introdotte diverse funzioni della Libreria GD; all'indirizzo 
Internet www. boutell.com/gd/, inoltre, è possibile scaricare un manuale relati- 
vo a essa. 

Manuale di PDFLib 

Il Capitolo 32 illustrerà come utilizzare PHP per creare in modo dinamico documen- 
ti Adobe PDF. PHP crea tali documenti sfruttando una libreria estema di funzioni 
nota con il nome di PDFLib. Questa libreria di funzioni è molto ampia, pertanto pre- 
senteremo solo alcune funzioni tra le più utilizzate. 

I dettagli completi di tutte le funzioni di PDFLib disponibili sono reperibili al sito 
Web di PDFLib (www.pdfiib.com/products/pdfiib/downioad/index.html) 

dove si può scaricare l'intera documentazione, come mostrato nella Figura 3.4. 
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Figura 3.4 

La pagina per scaricare la documentazione di PDFLib. 
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Risorse PHP online 

Oltre al sito ufficiale di PHP, esistono molte utili comunità online create da e per gli 
sviluppatori PHP. La Tabella 3.2 offre un riepilogo di alcuni tra questi siti che meri- 
tano una visita. 



Tabella 3.2 Risorse PHP online. 



Nome 


URL 


<?PHPBuilder?> 


www.pnpbuilder.com 


DevShed 


www.devshed.con 


Wcbmonkey 


hotwired.lycos.com/webmonkey/programming/php/ 


llotscripts.com 


www.hotscripts.com/PHP/Scripts and Programs/ 



Moki di questi siti comprendono forum dove è possibile esporre i propri problemi 
e ricevere le risposte (in genere valide, anche se non sempre) dalla comunità PHP 
elei Web. 



Riepilogo 

In questo capitolo abbiamo spiegato quali sono i componenti software necessari 
per creare un ambiente di sviluppo PHP. Si è visto inoltre dove è possibile accedere 
.il manuale di PHP, sia come risorsa online sia come manuale scaricabile. Abbiamo 
Inscritto dove è possibile ottenere il manuale per il database MySQL e per le varie 
librerie di funzioni che saranno utilizzate nel prosieguo del libro. Nel prossimo Cà- 
I >ii ( )lo presenteremo il primo script PHP e descriveremo il ciclo vitale dello sviluppo 
del software PHP. 



Capitolo 4 

Il primo programma PHP 



Introduzione 

In questo capitolo verrà presentato un primo script PHP, oltre alle informazioni ne- 
I essane per creare, salvare ed eseguire gli script. Spiegheremo come vengono se- 
gnalati gli errori negli script e come dovete comportarvi quando vi imbattete in essi. 

Un primo script PHP 

Iniziamo esaminando un primo script PHP: 
• Vphp 

// Primo - Esempio 4-1 
// 

tono "Salve a tutti e benvenuti nel primo script PHP."; 

^esempio è stato volutamente mantenuto il più semplice possibile, in quanto l'in- 
ptlto era mostrare come appare uno script PHP. Le righe dello script precedente sa- 
i.mno esaminate una per una. 

Lhp 

Questa riga segna l'inizio di una serie di istruzioni PHP. Le due righe che iniziano 
» in "//" sono commenti: 

// Primo - Esempio 4-1 
Il 



\ i ilendo è possibile omettere queste righe, In quanto il loro unico scopo è fornire 
Jtruzloni e informazioni destinale a rlii legge il codice, ma che vengono ignorate 
dal computer. La riga successiva inizia con l'istruzione echo: 



toho "Salve a tutti e benvenuti nel primo «cript PHP,"; 



Questa istruzione comunica .il pan» 'li inviare alla pagina Web le informaziou. 
tenute tra le doppie virgoliti.- sin . essive all'istruzione echo. Infine trovate la riga: 



?> 



Questa indica la fine delle istruzioni PHP. Le righe vuote dello script non hanno alcun 
significato e vengono incluse semplicemente per agevolare la lettura dello script. 

Modifica degli script PHP 

La prima operazione da compiere quando vi trovate di fronte a uno script PHP come 
il precedente è immetterlo nel computer e salvarlo. Gli script PHP vengono memoriz- 
zati come semplici file di testo e in quanto tali richiedono un editor di testo per poter 
essere immessi, modificati e salvati. Come già detto, potete utilizzare qualunque edi- 
tor di testo (per questo libro è stato utilizzato Blocco note con Windows). La Figura 
4.1 illustra lo script precedente inserito nel Blocco note di Windows. 



Sy esempio4- 1 .php - Blocco note 



<?php 

// Primo - Esempio 4.1 
// 1 

echo "salve a tutti e benvenuti nel primo script PHP."; 



Figura 4.1 

La finestra di Blocco note con uno script PHP al suo intemo. 



Salvataggio degli script PHP 

La posizione esatta in cui vengono salvati gli script PHP dipenderà dall'ambiente di svi- 
luppo utilizzato, e in particolare dal server Web installato. Sul computer utilizzato per 
questo libro era installato il server Web Internet Information Services per Windows, che 
di default crea la struttura di directory standard seguente sull'unità C:\ del PC: 



C:\ 

+ inetpub 
+ unvwmol 
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TUttl I documenti HTML e gli script PHP devono essere salvati nella directory 
U ti wwol o in sottodirectory di quest'ultima. Nel nostro caso è stata creata la struttu- 
ri di directory seguente sotto la directory twwroot: 

C\ ' ■ 

• hwl/iiih 
fc ' ii ■in /'mot 

+ phpbook 

ffiles 

' graphics 

+ pdf 

+ uploads 



gli script PHP degli esempi verranno memorizzati nella directory phpbook, 
mire le altre sottoclirectory al di sotto di essa verranno impiegate nei capitoli sue' 
ni per memorizzare i file generati, le immagini, i documenti PDF e qualunque 
■Ih- venga caricato. Per salvare lo script PHP nella directory phpbook con Blocco 
e occorre selezionare l'opzione File/Salva con nome, portarsi alla directory 
nhook e inserire un nome di file per lo script, che deve terminare in .php. Abbia- 
M ' Ilo di salvare il file come esempio4-l php. Osservate che con Blocco note do- 
uccertarvi che l'opzione Salva come sia impostata su Tutti i/ile. altrimenti il 
IMtigramma aggiungerà l'estensione .rxt ai file salvati e questi non funzioneranno 
l'i la mente. La Figura 4.2 illustra quanto appena detto. 



Salva in: 
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Figura 4.2 

Mggio dei file in Blocco note. 




J0 esempio) 0-1. php 
@D esempio 10-2, php 
fD esempiolQ-3,php 
SJ esernp!ol0-4,php 
jO esernpiol2-4,php 
10 esempiol2-5.php 
jO esempio 12-6, php 
JO esempiol5-l,php 
CU esempiol5-2,php 
JO esernpiol5-3,php 
jf] esempiol5-4,php 



l=J esempiol5-5.php 
lD esempiol5-6.php 
80 esempio4-l.php 
E) esempio4-2,php 
lU esempio4-3,php 
10 esempio5-l.php 
H esempio5-2.php 
@] esempio5-3,php 
|SJ esempio5-4,php 
IO esempio5-5,php 
@j esempio6-l,php 



esempio6-2,php 
esempio6-3,php 
esempio6-4,php 
esempio7-l,php 
esempio7-2,php 
esempio7-3,php 



sJ esempio3-6.php 
p esempio8-7.php 
J3 esempio8-8,php 
ij esempio9-l,php 
jO esernpio9-2.php 
3 esempio9-3.php 
esemptoè-l.php @ esempio9-4.php 
esempio8-2.php 
es e mpio8-3.php 
esempio8-4.php 
esempio8-5.php 




■'■/' 



Infine, per salvare il l'ile- dmvtc Lite . li. mi Salivi 



M Capitolo 4 



Visualizzazione dell'output PHP 



Una volta creato e salvato lo script, potete visualizzare l'output che produce. A tal 
fine dovete procedere nel modo seguente. 

1. Utilizzare un client Web (noto anche come browser Web). Per tutti gli 
esempi del libro verrà utilizzato Microsoft Internet Explorer, tuttavia, dato 
che PHP genera codice HTML, gli script presentati dovrebbero funzionare 
con qualunque browser Web. 

2. Accertarvi che il server Web sia in esecuzione, in quanto sarà necessario per 
elaborare gli script PHP. 

Per visualizzare l'output dello script precedente dovete digitare, nel campo degli in- 
dirizzi del browser, l'indirizzo seguente: 



http://localhost/phpbook/esempio4-1 .php 



Questo indirizzo Web è di tipo "locale" e viene utilizzato solo a fini di sviluppo, 
quando il server Web impiegato si trova sul medesimo computer sul quale avviene 
lo sviluppo degli script. Esaminiamo il significato di questo indirizzo: 

• http : / / indica che si tratta di un indirizzo Web HyperText Transfer Proto- 
col; 

• localhost è il nome del server Web: come si è detto, si tratta di un indiriz- 
zo utilizzato a fini di sviluppo; 

• /phpbook è la directory in cui sono memorizzati gli script; 

• /esempio4 - 1 . php è il nome dello script. 

L'output prodotto da questo script è quello della Figura 4.3. 



■[1 http://localhost/phpbook/es empio4- 1 .php - Microsoft Internet Enploif:r 
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Salve a tutti e benvenuti nel primo script PHP. 




Figura 4.3 

Il primo script PHP. 
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Un secondo script PHP 

Provate ora con un altro script un po' più complesso: 
<?php 

'/ Primo - Esempio 4-2 

'/ 



echo "Oggi è il " . showDate(); 



function showDate() { 

Sdate = getthedate() ; 

return ($date[ "year" ] $date[ "mon" ] . '-' $date[ "mday"]) ; 

Al momento non spiegheremo il funzionamento dello script, i cui diversi compo- 
nenti saranno presentati e analizzati nei capitoli successivi. Esso infatti è stato rea- 
lizzato solo per illustrare come PHP possa generare una semplice pagina Web di- 
namica. Inserite e salvate lo script precedente nella directory del server Web e vi- 
sualizzate lo script risultante nel browser Web. L'output prodotto è quello della 
Figura 4.4. 



H hi tp:,. '/ Iocalhost/phpbook/esempio4-2.php - Micr osoft Internet Explorer 
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http : localhost/phpbook/esempio4-2 , php 




Fatai error: Cali to undefined function: getthedateO in 
e:\inetpub\wwwroot\phpbook\esempio4-2.php on line 10 




jra 4.4 

econdo script PHP produce un errore. 



lessaggi di errore 

A quanto pare c'è un problema, pi .i. Iié ,1 secondo script PHP ha prodotto un mes- 
IBggio di errori'. 



Fatai error: Cali to undoflnod funi li -u,u-i i m 



In realtà si tratta di un errore voluto, per mostrare come appare un messaggio di er- 
rore e cosa occorre fare per correggerlo. Il messaggio di errore implica che esiste un 
problema relativo alla riga: 

$date = getthedate(); 

In realtà infatti essa dovrebbe essere scritta nel modo seguente: 
$date = pettate (j; 

Ecco quindi lo script corretto: 
<?php 

// Primo - Esempio 4-3 

echo "Oggi è il 11 . showDate(); 
function showDatef) { 

$date = getdatef); 
^ return ($date[ "mday" ] . $date["mon"] . Sdate[ "year" ] ) ; 

Correggete lo script e salvatelo nuovamente. Se lo salvate con lo stesso nome di 
quello contenente l'errore, fate semplicemente clic sul pulsante Aggiorna del brow- 
ser; se invece avete scelto un nuovo nome, digitate nuovamente l'indirizzo nel 
browser e premete il tasto Invio. Lo script questa volta dovrebbe funzionare corret- 
tamente e dovrebbe visualizzare la data odierna, come mostrato nella Figura 4 5 
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Figura 4.5 

Il secondo script PHP. 



Lo script presentato è di tipo dinamico e visualizzerà la data corretta ogni volta che 
decidete di visualizzarne l'output. 



In i |uesto capitolo sono stati presentati i primi script PHP assieme a una spiegazione 
di C< >me immetterli e salvarli sul proprio computer. Abbiamo spiegato come sia pos- 
sibile visualizzare l'output degli script e come appaiono i messaggi di errore quan- 
| Il i si verificano problemi. Il prossimo capitolo proseguirà nell'esame di PHP analiz- 
zili lo in modo più approfondito alcuni elementi fondamentali del linguaggio. 




Capitolo 5 

Nozioni fondamentali 
di PHP 

■ 



ntroduzione 

Questo capitolo prende in esame in modo più approfondito alcuni aspetti fonda- 
• limitali dello sviluppo con il linguaggio PHP. Si vedrà com'è possibile incorporare 
B li script PHP nei documenti HTML, come formattare gli script, il ruolo dei com- 
menti e l'istruzione echo. 



Dentro e fuori da PHP 

In precedenza si è visto che uno script PHP deve iniziare con l'istruzione <?php e 
terminare con ?>. Quindi, per esempio, il primo script PHP è stato illustrato nel 
modo seguente: 

<?php 

//Nozioni fondamentali - Esempio 5-1 

// --- -- 

echo "Salve a tutti e benvenuti nel primo script PHP."; 
?> 

Tuttavia gli script PHP possono essere incorporati nei documenti HTML generando 
una mescolanza di codice HTML e PHP. Considerate l'esempio che segue: 

<body> 

Salve, questo è codice HTML standard 
"?php 

// Nozioni fondamentali - Esempio 5-2 

yi- ■• 

echo " mentre questo è genornto da PHP."; 
?> 

</body> 



L'esempio precedente inizia con un tag HTML <B0DY> seguito da una siringa di te- 
sto, "Salve, questo è codice HTML standard", Poi trovate uno script PHP che 
utilizza il comando echo per visualizzare il testo "mentre questo è generato da 
PHP" . Dopo l'elemento di chiusura ?> di PHP si ritorna al codice HTML con un tag 
body di chiusura. Il fatto interessante è la possibilità di entrare e uscire da PHP tutte 
le volte che si vuole in un documento HTML. Considerate l'esempio seguente: 

<body> 

Salve, questo è codice HTML standard 
<?php 

8R : . • ■ ' ' '"■ ■; '. -.v '* 

// Nozioni fondamentali - Esempio 5-3 

.7/'----------, ■ 

echo " mentre questo è prodotto con PHP."; 
?> 

Ora eccoci di nuovo in HTML 
<?php 

echo " mentre questo è ancora una volta PHP."; 

|1f^ ? '' ' ' '■' " ' 1 ' ' ' ' $&**-Mfi" 

Per finire, utilizziamo ancora HTML. 
</body> 

Questo esempio illustra che non siete limitati a un solo script <?php ?>, ma che potete 
includerne diversi. L'output prodotto dallo script precedente è quello della Figura 5.1. 



,, • • • — "J,_^iui!Lj — „j.„.,._,4ULU- m , — .J.,....U- 

J. http: i localhosl/ phpbook > esempio5-3.php - Microsoft Internet Explorer 


.*;v;>5i.v'.. .... 




Fila Modifica Visuali22a Preferiti Strumenti ? St^fi g 


^Indietro - * - % [|] $ ^Cercs (M Preferiti ^Multimedia 


%' # 1 


ì- 




Indirizzò \{Q http://localhost/phpbook/esernpio5-3.php 


" r i^vVal 


Collegament 


» 


Salve, questo è codice HTML standard mentre questo è prodotto con PHP. Ora eccoci di 
nuovo in HTML mentre questo è ancora una volta PHP. Per finire, utilizziamo anc ora 
HTML. 
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Dentro e fuori do PHP. 



Formattazione delle istruzioni PHP 



Il linguaggio di scripting l'I II» e piuttòsto tollerante sulla disposizione delie proprie 
istruzioni. Per esempio, queste righe: 

<?php 

echo "Ciao a tutti"; 
?> 

sono un modo perfettamente accettabile di includere istruzioni PHP in un docu- 
mento HTML; anche' la riga seguente, però, è altrettanto valida: 

<?php echo "Ciao a tutti" ?> 

Osservate che nel secondo esempio manca il punto e virgola (;) alla fine dell'istru- 
zione echo. Esso viene utilizzato per terminare un'istruzione PHP, proprio come av- 
viene con il tag ?>; pertanto può essere omesso quando il codice PHP è scritto su 
una sola riga. 

Va detto, però, che la prima forma in genere è di più agevole comprensione, ragio- 
ne per cui tutti gli esempi del libro saranno presentati con questo stile. Se volete, 
potete rendere totalmente illeggibili gli script collocando molte istruzioni separate' 
Sulla stessa riga. Per esempio: 

<?php 

// Nozioni fondamentali - Esempio 5-4 

.//•-■ 

ocho "Oggi è il " . showDate(); function showDate() 

{$date = getdate() ; 
return ($date[ "year" ] . $date["mon"] . '-' . $date[ "mday" ] ) ; } 

(.lucila appena presentata è una riscrittura dello script esempio4-3.pbp per la visua- 
lizzazione della data presentato nel capitolo precedente. Si consiglia di non trascu- 
rile la leggibilità degli script, in quanto vi accorgerete che essa agevola la correzio- 
ni- degli errori, l'intxoduzione/di modifiche o la semplice comprensione del funzio- 
namento di uno script. 

Istruzioni echo e print 

ocho è un costrutto del linguaggio PHP che consente di visualizzare stringhe di te- 
sto sulla pagina Web. 

Abbiamo già usato echo per visualizzare il testo negli script di esempio precedenti, 
tuttavia ecco un altro esempio di questa istruzione: 

echo "Ciao"; 

'.mesta istruzione echo visualizza il testo "Ciao" sulla pagina Web. Le virgolette 
doppie (") indicano l'inizio c Li line- clc-l testo da visualizzare. In questo esempio il 
lesto "Ciao" è molto breve, tuttavia m aveste una quantità di testo molto maggiore 



da visualizzare, poneste .suddividere le stringhe di esempio su più righe, come in 
(|iiesio esempio: 

echo "Ciao, questa stringa 

occupa diverse 

righe"; 

Questo script visualizza il testo "Ciao, questa stringa occupa diverse ri- 
ghe", che verrà visualizzato su una sola riga, non suddiviso su più righe come po- 
treste immaginare. Potete provare voi stessi visualizzando lo script seguente: 

<?php 

// Nozioni fondamentali - Esempio 5-5 

//. • f; . . .^j'nli v s: V ;y : 

echo "Ciao, questa stringa 

occupa diverse 

righe"; 



L'output è illustrato nella Figura 5.2. 
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Figura 5.2 

Istruzione echo su più righe. 



L istruzione echo consente di visualizzare variabili e più stringhe di caratteri, come 
si vedrà nei capitoli successivi, PHP supporta anche un'altra istruzione per agevola- 
re l'output, print, che funziona esattamente come echo: 



print "Salve a tutti" ; 



1NUÌ.1U111 luiiudmeritau ai rnr jj 



Questa istruzione visualizzerà il leMo "Salve a tutti". Nei vostri script potete utilizza- 

differentemente echo o print. 

Tutti gli esempi del libro utilizzano echo. 

Commenti 

l'Ili' supporta tre forme di commenti, che possono essere inclusi per aiutare chi leg- 
il codice a comprendere il funzionamento dello script PHP. Il primo tipo di com- 
mento occupa più righe ed è uguale a quello introdotto dal linguaggio di program- 
mazione C: 

/• Questo è un commento 
«ho può essere separato in 
più righe */ 

il uteri /* indicano l'inizio del commento, che si chiude in corrispondenza dei 
■ iratteri */. La seconda forma di commento è a riga singola ed è uguale a quello in- 
lotto dal linguaggio di programmazione C++: 

II commento a riga singola. 

iratteri / / indicano l'inizio di un commento a riga singola. Infine, la terza forma 
i munenti PHP è analoga a quelli della shell UNIX e anch'essa occupa una sola 

f Un altro commento a riga singola. 

! 1 1 munenti vengono ignorati dal parser PHP e sono di aiuto solo per chi legge il co- 
■ m quanto spiegano cosa sta accadendo. Tutti gli script completi di questo libro 
ino con due righe di commento simile alle seguenti: 

// Nozioni fondamentali - Esempio 5-4 
'/ 

wr v ' ■ 

• [UCSto commento fornisce il nome dello script e indica come dovrebbe essere sal- 
ano Nell'esempio precedente, datò che il nome è Esempio 5-4, dev'essere salvato 
Come esempio5-4.php. Il nome dello script consente di sapere che si tratta 
dell'Esempio 4 del Capitolo 5. 

li esempi i commenti sono stati evitati il più possibile e, quando presenti, si è 

• tratto di ottenere la massima brevità e semplicità. 

Riepilogo 

In questo capitolo abbiamo visto come si costruisce uno script PHP e i mezzi che 
Consentono di incorporarlo in un documento HTML. Abbiamo esaminato l'istruzio- 
ne echo e il ruolo dei commenti nel linguaggio. Il prossimo capitolo proseguirà 
•analisi del linguaggio l'Ili' e presenterà le variabili. 
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Capitolo 6 

Introduzione alle variabili 



Introduzione 

in questo capitolo verrà introdotto il concetto di variabili, esaminando come vengo- 
|)i i definite e utilizzate in PHP, le limitazioni al loro impiego e la loro grande impor- 
• m/a. Per cominciare spiegheremo che cosa sono le variabili. 

I 

Che cos'è una variabile? 

1 1 \ .inabili sono contenitori dotati di nome, in grado di contenere valori. Il valore 
petenuto da una variabile può cambiare durante lesecuzione dello script, da cui il 
ih ime di "variabile". Le variabili possono contenere numeri, caratteri o stringhe che 
ne irmalmente rappresentano qualcosa, come per esempio date, cognomi o salari, 
i imu- le variabili hanno un nome univoco, che consente di fare riferimento a esse in 
un «lo non ambiguo. 



Variabili in PHP 

Li variabili in PHP sono definite dal simbolo di dollaro ($) seguito dal nome della 
variabile. Il nome distingue tra maiuscolo e minuscolo e pertanto $SIMON è diverso 
(la $simon. I nomi delle variabili devono iniziare con una lettera o un carattere di 
sniiolineatura, che può essere seguito da un numero qualunque di lettere, numeri o 
i iratteri di sottolineatura. 

Beco per esempio alcuni nomi di variabile validi: 

Inaine; 

$chapter45; 
•_var; 

Duello che segue è invece un nome di variabile non accettabile, in quanto non ini- 
zi, i con una lettera o un carattere di sottolineatura. 



$lstNanie; 



Assegnare a variabili per valore 



nominate Stax .3 fiu . esem P'°> supponiamo di avere due variabili de- 









$tax 


♦ 




hi 17.,' . ,:•;.< ;ìa .. 

■ •"■ - •. . fi:'.' n ' 


Variabile &tax 




Variabile &net 




$net 




200 






Variabile $copyOfNeI 
• (è un duplicalo del valore 




SoopyOINel 




— * 

200 


f- ,-ì memorizzato in &net) 







Figura 6.1 

Assegnare a una variabile per valore, 



<?php 

// Variabili - Esempio 6-1 

Stax = 17; 
$net = 200; 
$copy0fNet = $net; 
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ili $net. Tutto questo mostra . la- alle variabili è possibile assegnare non solo co- 
stanti, ma anche i valori di altre variabili. 

I 

Assegnare a variabili per riferimento 

WL< >'A"i J ,(i / i , , 

introduzione di PHP 4 ha portato con sé un altro modo di assegnare valori alle va- 
riabili, l'assegnamento per riferimento, grazie al quale la nuova variabile diviene yn 
■■'■mpiice riferimento, noto anche come alias, alla variabile originale; a volte viene 
utilizzata l'espressione di "puntamento alla" variabile. La Figura 6.2 illustra quanto 
appena detto. 



$tax 


*-- — .. 









Variabile Stax 



$nel 



200 



Variabile &nel 



ScopyOfNet 



Riferimento alla variabile &net 



Variabile $copyOfNel 

(non contiene effettivamente un valore in quanto 
fa riferimento a quello contenuto in Snet) 



Figura 6.2 

Assegnare a una variabile per riferimento. 



In questo caso una modifica alla variabile originale o a quella nuova influisce su en- 
trambe. Dato infatti che non viene effettuata alcuna copia, questa forma di assegnai- 
mento può portare a un aumento delle prestazioni, anche se non è così facile ren- 
dersene conto. Oltre a ciò, osservate che l'assegnamento a una variabile per riferi- 
mento non consente di assegnare una costante. Per ottenere un assegnamento per 
perimento, dovete semplicemente aggiungere una e commerciale (&) all'inizio del- 
la variabile che viene assegnata. Lo script dell'esempio seguente illustra l'assegna- 
mento per riferimento: 

<?php 

// Variabili • Esempio 6-2 

<j[l 



$tax = 17; 
$net = 200; 
ScopyOfNet = &$net; 
?> 



Visualizzazione delle variabili 

!'h J l'egte POSSOn ° 65Sere VÌSUalÌ2Zate con istruzione echo ; considerate l'esempio 
<7php 

// Variabili ■ Esempio 6-3 
// 

$tox ■ 17; 
$not - 280; 
JoopyOfNGt = &$net; 
$nnothorCopy ■ $net; 

.1 

Init • 100; 

ocho $copy0fNet; 
ocho lanotherCopy; 

?> 

Lo scripl precedente definisce quattro variabili: $tax e $net sono inizializzate con i 

SanothoTnnv , 7 nab,le k .f n f viene P oi ugnala per valore alla variabile 

ScodvS Np?^ feì 3 V ^" ablIe $net Vi6ne ÌmpOStata al valore 100 e le v ^iabili 
f ^Tl < $anothe ^opy vengono visualizzate attraverso istruzioni echo 
L output di questo scnpt è illustrato nella Figura 6.3. 
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Figura 6.3 

Output delle variabili. 



pOUtput prodotto da qucslo Miipi, ,m. he se non è presentato in modo elegante, il- 
lusila che la variabile che ricevo l'assegnamento per riferimento cambia il proprio 
Valore da 200 a 100 quando la copia originale ($net) viene alterata. La variabile 
SanotherCcspy invece, che ha ricevuto un assegnamento per valore, mantiene il va- 
lore originale 200. 

Dichiarazione di variabili 
senza assegnamento di valori 

Non è consigliabile dichiarare una variabile e poi utilizzarla prima di assegnarle un 
Valore, in quanto non è possibile sapere quali dati siano effettivamente memorizzati 
m essa, a meno che la definiate espressamente. Considerate lo script seguente: 

<7php 

// Variabili - Esempio 6-4 
W 

$tax; 

ocho $tax; 
?> 

Questo esempio genererà un messaggio di errore al momento dell'esecuzione dello 
script, in quanto l'interprete non sa a quale valore dev'essere impostata la variabile. 
Questo errore è illustrato nella Figura 6.4. 
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Notice: Undefined variable: tax in 
e:\inetpub\'wwwroot\phpbook\esempio6-4.php on 


line 5 








Notice: Undefined variable: tax in 
e:\inetpubWw\woot\phpbook\tsempio6-4.php on 


line 7 








Operazione completata | ,,f; 


li Intranet locate 









Figura 6.4 

Avviso di variabile indefinita. 



Tipi di variabili 



i aoella o. 1 


Tipi di variabili 




Tipo 


descrizione 


Capitolo 


Boolean 


Una variabile booleana esprime un valore di verità che ™,n 


—7 




essere TRUE o FALSE. ' puo 


7 


Integer 


Una variabile intera è un numero anmrrpnent,* *n 

7_i -, , „ , „ 'i«uuiuu afjyai lenente au insieme 


7 




& —Z, -1, 0, 1, 2, ...). 




float, 


reali? ^ f0rmat ° 3 VÌf80la m ° bile Canche detti " num ™ 




doublé 




7 


String 


vale a un 8 byì Una dÌ In PHP un ca « equi- 


8 








Array 


Sequenza indicizzata di una o più variabili 


14 


Object 


y™!t Spedale definiti i Stente, nell'ambito dalle pro- 


37 


Resource 


grammazione orientata agli oggetti. 1 






Una risorsa è una variabile speciale che contiene un riferi- 






mento a una risorsa esterna, per esempio a un database. 


36 


NULL 


1NU1X rappresenta una variabile priva di valore 


7 



Tabella 6.2 Pseudo-tipi di variabili 

T 'P° Descrizione ~~ ■ 

^ ^L C ntuZ Pm0 dÌ fUnZÌ ° ne PUÒ 3CCettare P iù W 

Number Machefl parametro può essere un intero o un valore in vir- - 

Callbac k ^^«g^cca» parametro i valori restituiti da 24 



Casting di tipo 

$var = 4; 

$bool = (Boolean) $var; 



mili uuutiunc une vai idum 



T«bolla6.3 Casting 



Casting 



(int), (integef) 

(bool), (Boolean) 

i Moat), (doublé), (real) 

(string) 

(array) 

(object) 



Descrizione 



Casting a intero. 

Casting a booleano. 

Casting a un tipo in virgola mobile. 

Casting a stringa. 

Casting ad array. 

Casting a oggetto. 



Ambito delle variabili 

l .unhito di una variabile è il contesto nel quale viene definita; in genere esso ab- 
braccia l'intero script PHP, tuttavia esistono alcune eccezioni, tra le quali troviamo 
■ i unzioni. Le variabili definite all'esterno delle funzioni non hanno alcun ambito 
ili interno della funzione, mentre le variabili definite all'interno della funzione non 
' nino ambito al di fuori di essa. Nel caso delle classi troviamo una situazione simi- 
li- L ambito delle variabili all'interno delle funzioni è analizzato nel Capitolo 13. 
Rientre le classi sono argomento del Capitolo 37. 



Riepilogo 

I Jucsto capitolo ha introdotto il concetto di variabile, illustrando come possono es- 
tere dichiarate in PHP e come sia possibile assegnare loro i valori. Abbiamo anche 
ii i ino brevemente i diversi tipi di variabile riconosciuti da PHP. Nel prossimo ca- 
l >li i verranno analizzati in modo più approfondito i tipi booleani, interi e in virgo- 
la mobile. 



Capitolo 7 

Tipi booleano, intero 
e in virgola mobile 

Hi,', ; ' : 



Introduzione 



In questo capitolo verranno esaminati in modo più dettagliato tre tipi di variabile: 
" ©oleario, intero e in virgola mobile. Inizieremo tuttavia spiegando come PHP sup- 
>rti le definizioni esplicite di tipi. 




PHP effettivamente non supporta le definizioni esplicite di tipi, a differenza di altri 
linguaggi di programmazione. In altre parole, al momento della creazione di una 
variabile non se. ne specifica il tipo, che viene invece determinato dal contesto in 
cui essa viene utilizzata. Quindi, per esempio, se definite una variabile e le assegna- 
te un intero, essa Sarà di tipo intero; se in seguito le assegnate un valore in virgola 
mobile, la variabile diventerà di tipo in virgola mobile. 

Tipi booleani 

I booleani sono il tipo più semplice. Un valore booleano esprime un valore di verità 
che può essere TRUE o FALSE. L'esempio che segue illustra la dichiarazione di una 
variabile e l'assegnamento a essa del valore TRUE: 

<?php 

// Booleani, interi e float - Esempio 7-1 



ekday = TRUE; 



echo $weekday; 
?> 
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L'output di questo esempio è 1 e non il testo TRUE. Ciò avviene perché PHP utilizza 
il valore 1 per rappresentare TRUE e 0 per rappresentare FALSE; pertanto il contenu- 
to di una variabile booleana sarà 1 o 0 una volta visualizzata. 

Conversione a booleano 

Come accennato nel capitolo precedente, per convertire in booleano possiamo uti- 
lizzare il cast (bool) o (Boolean). Nella maggior pane dei casi non sarà necessa- 
rio ricorrere a un cast esplicito, in quanto il valore sarà convertito automaticamente. 
Tuttavia, quando convertite a booleano da altri tipi di variabile, dovere sapere come 
verranno convertiti alcuni valori. La Tabella 7.1 offre un riepilogo di queste conver- 
sioni. 



Tabella 7. 1 Conversioni booleane 


Convertito come 


Conversione 




FALSE 
FALSE 
FALSE 
FALSE 
FALSE 
FALSE 
FALSE 
FALSE 


Un FALSE booleano. 

Il valore intero 0. 

Il valore in virgola mobile 0.0. 

Una stringa vuota e una stringa " 0 " . 

Un àrray di zero elementi. 

Un oggetto con zero variabili membro. 

Il tipo speciale NULL. 

Tutti gli altri valori. 




Interi 






Un intero è un numero appartenente all'insieme (..., -2, -1, 0, 1, 2, ,. 


1. La dimensio- 



ne massima di un numero intero dipende dalla piattaforma, ma normalmente è 
nell'ordine dei 2 miliardi. I numeri interi possono essere specificati con la notazione 
decimale, come mostrato di seguito: 

$var =123; 
$var2 = -123; 

In questo esempio $var viene definita come intero positivo di valore 123, mentre 
$var2 è definita come intero negativo di valore -123. Come in alcuni altri linguag- 
PHP consente di definire gli interi in altre basi numeriche, in particolare ottale ed 
decimale: 

' = 0123 ; 

" = 0x1a; 

jf v .. 

In questo caso $var è definita come numero 1 23 ottale, equivalente a 83 in notazio- 
ne decimale. I numeri ottali vengono definiti con uno 0 che precede il numero. A 
$var2 viene invece assegnato il numero 1a esadecimale, equivalente a 26 in deci- 
male. I numeri esadecimali sono definiti anteponendo 0x al numero. Se non riuscite 
a cogliere perché 1 23 in ottale equivale a 83 in decimale o perché la esadecimale è 
equivalente a 26 in decimale, osservali 1 la Figura 7.1. 
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Centinaia 


Decine 


Unità 


Decimai 


3 




8 


3' ' 

















8x10 


+ 3 


= 83 




Ottali 



64 



Unità 





1x64 


2x8 








+ 3 


= 83 










1 





256 


16 


Unità 




l 










Esadecimale 




1 


a 



















1 x16 


+ 10 


= 26 










1 : 







il" 



igura 7.1 

lappresentazione di numeri decimali, ottali ed esadecimali. 



Conversione a intero 



È possibile convertire a intero con i cast (int) o (Integer). La Tabella 7.2 elenca 
le specifiche conversioni di valore che avranno luogo. 



Tabella 7.2 Conversioni a intero 







Convertito come Conversione 





mws'À 



Un TRUE booleano. 
Un FALSE booleano. 

La conversione a un tipo in virgola mobile produrrà un numero arro- 
tondato per difetto. 

La conversione delle stringhe è descritta nel Capitolo 8. 

La conversione da altri tipi non è definita nel linguaggio PHP. 



Overflow del tipo intero 

Se specificale un nume ili in • In uipcru I limili del lipo intero, esso sarà inter 

ptviaui uuiomaiicamenU' vul | virgola mobile 



Funzione var_dump 



Anche se le funzioni saranno analizzate in modo più approfondito più avanti è uti- 
le introdurre a questo punto una funzione chiamata var_dump( j; che visualizza il 
tipo di una variabile che le viene passata. Il formato della funzione è il seguente- 
La sintassi della funzione è la seguente. 

Void var_dump(mixed variabile); 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


variabile 


Mixed 


La variabile che desideriamo esaminare. 


Restituzione di var_durap ( ) 


Void 


Non restituisce alcunché. 



Esempio di funzione: 
var_dump $(vab); 

Possiamo utilizzare questa funzione per determinare il tipo delle nostre variabili 
Considerate l'esempio seguente: 

<?php 

// Booleani, interi e float - Esempio 7-2 

// -- 

$smalllnt = 1 ; 
$bool = TRUE; 

$largelnt = 12345678901234567890; 

var_dump (Ssmalllnt) ; 
var_dump (Sbool); 
var_dump (Slargelnt) ; 

L'output di questo script, illustrato nella Figura 7.2, mostra che $smalllnt è di tipo 
intero, $bool è booleana, mentre $largelnt viene effettivamente memorizzata 
come valore in virgola mobile. 

Tipi in virgola mobile 

I numeri in virgola mobile (noti anche come doublé, f loat o real) possono esse- 
re specificati con il ricorso a una qualunque tra le forme sintattiche seguenti: 



$var1 = 1 .234; 
$var2 = 1.2e3; 
$var3 = 7E-10; 
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int(l) bool(true) float(1.23456789012E+19) 




figura 7.2 

a funzione var_dump, 



dimensione di un numero in virgola mobile dipende dalla piattaforma, tuttavia 
potete considerare in generale un massimo di 1.8e308. I valori in virgola mobile 
l'M sentano un problema di precisione. Considerate l'esempio seguente: 

• Vphp 

il Booleani, interi e float - Esempio 7-3 
Il 

9ne = 1; 
ree = 3; 
•third = $one/$three; 

»cho Sthird; 



in questo esempio il valore di $third è 0.333333333333. 1 programmatori devono 
'•Mere consapevoli di questa perdita di precisione quando si effettuano calcoli con i 
numeri in virgola mobile. 



Conversione in virgola mobile 

possibile convertire a valore in virgola mobile con i cast (float), (doublé) o 
| real) . Le conversioni di stringhe in valori in virgola mobile verranno descritte nel 
I irossimo capitolo, nel paragrafo dedicato alla conversione delle stringhe in numeri. 



Riepilogo 



In questo capitolo sono stati analizzati i tipi booleano, intero e in virgola mobile, il- 
lustrimelo come possono essere definiti e ionie sia possibile convenire un tipo in un 
Btro, Nel prossimo capitolo veir.mno ,uuli*/.:iti in modo più approfondito i tipi di 
variabile stringa. 



Capitolo 8 

Stringhe 



Introduzione 

In questo capitolo verrà esaminato il tipo di variabile stringa. Le stringhe sono se- 
BUenze di caratteri alfanumerici e sono già state utilizzate in uno o due esempi di 
script PHP, in particolare come parte dell'istruzione echo. Inizieremo esaminando 
P imt ' vengono definite le stringhe in PHP, per poi analizzare i diversi tipi di stringa 
.1 disposizione. Dovremo poi capire come unire le stringhe, accedere ai singoli ca- 
pateli di una stringa e convertire le stringhe in numeri. 

Tipi stringa 

In PHP la specificazione delle stringhe può avvenire in due modi: è infatti possibile 
utilizzare i caratteri " "' o " " " per indicare l'inizio e la fine della stringa. Per esempio: 

SmyString = 'Prima stringa'; 
SanotherString = "Un'altra stringa"; 

In questo esempio SmyString viene definita come stringa contenente i caratteri 
' Prima stringa ' , mentre SanotherString viene definita come stringa contenen- 
te I caratteri "Un 1 altra stringa". Esiste allora qualche differenza tra le due for- 
me? La risposta può essere sì o no in relazione al contesto in cui viene impiegata la 
siringa. Per esempio: 

<?php 

// Stringhe - Esempio 8-1 

Rfc" ----- 

SmyString = 'Prima stringa'; 
SanotherString = "Un'altra stringa"; 

ocho SmyString; 

echo "<br>"; 

echo SanotherString; 

?> 
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L'output dell'esempio precedente è il seguente: 



Prima stringa 
Un'altra stringa 



Sembrerebbe quindi che le stringhe con virgolette singole e quelle con virgolette 
doppie siano sostanzialmente identiche. Questo tuttavia non è del tutto vero, come 
si vedrà quando verrà analizzato in modo più approfondito il supporto che queste 
diverse stringhe hanno per le sequenze di escape per i caratteri. 

Stringhe con virgolette singole 

Le stringhe con virgolette singole possono contenere solo le sequenze di escape 
elencate nella Tabella 8.1. 



Tabella 8. 1 Sequenze di escape per i caratteri nelle stringhe con virgolette singole 
Sequenza Descrizione 



\\ Carattere barra contraria. 

V Carattere virgoletta singola. 



Queste sequenze di escape consentono di includere i caratteri "\" e " nelle strin- 
ghe. 

Considerate l'esempio seguente: 
<?php 

// Stringhe - Esempio 8-2 

V ■ ■■■■ ■■' ' ■ ' 

SmyString = 'Questa è una barra rovesciata: \\ ' ; 
$anotherString = ' e questa è una virgoletta singola: V'; 

echo SmyString; 
echo SanotherString; 

Ecco cosa visualizza lo script precedente: 
uesta è una barra rovesciata: \ e questa è' una virgoletta singola: ' 

I motivi per cui è necessario ricorrere alle sequenze di escape per questi caratteri 
sono due. 

1. Se desideriamo visualizzare una virgoletta singola come parte della stringa, 
dobbiamo segnalare al parser PHP che si tratta di un carattere da visualizza- 
re e non di un virgoletta che indica la fine della stringa. 

2. Utilizziamo il carattere barra rovesciata per indicare una sequenza di esca 
pe, pertanto dobbiamo ricorrere a una sequenza di escape quando deside 
riamo visualizzare proprio questo carattere. 



Stringhe 53 



Pi nuoto l'istruzione seguane produrrebbe un errore se venisse inserita in uno script: 
Ivnr3 = 'Questa virgoletta 1 invece produrrebbe un errore'; 

pi i avere una visualizzazione corretta, la riga dovrebbe essere scritta nel modo se- 
guente: 

*vnr3 = 'Questa virgoletta \' invece produrrebbe un errore'; 

è. 

Stringhe con virgolette doppie 

Con le stringhe a virgolette doppie, invece, le cose si complicano leggermente, a 
■ i iminciare dal numero di sequenze di escape per i caratteri che è possibile utilizza- 
i>'. che è molto più elevato. Osservate la Tabella 8.2. 



Tabella 8.2 Sequenze di escape per i caratteri nelle stringhe con virgolette doppie 



Sequenza 


Descrizione 


\n 


Ritomo carrello e avanzamento riga. 


\r 


Ritorno carrello. 


\t 


Carattere di tabulazione. 


\\ 


Barra rovesciata. 


\% 


Simbolo del dollaro. 


V 


Virgolette doppie. 


M8-7 ] 


Un carattere specificato in notazione ottale con 1-3 cifre. Il primo nu- 




mero è uno 0. 


\x|0-9A-Fa-f ] 


Un carattere specificato in notazione esadecimale con 1 o 2 cifre. Deve 




avere un carattere x prima del numero. 



i i sequenza \n costringe il cursore a saltare all'inizio di una nuova riga; la sequenza 
r i ostringe il cursore a saltare all'inizio della riga corrente; la sequenza \t inseri- 
Kc un carattere di tabulazione. Osservando gli esempi di questo libro noterete che 
queste sequenze di escape non sono molto utilizzate. 

I -i sequenza \ \ inserisce un carattere barra contraria; la sequenza \$ inserisce il ca- 
mttere dollaro; la sequenza \ " inserisce un carattere di virgolette doppie; le due se- 
quenze di escape finali consentono di specificare i singoli caratteri sotto forma di 
ni lina i ottali o esadecimali, in conformità con lo standard ASCII (American Stan- 
dard Code J òr Information Interchangé), un codice che assegna un valore numerico 
.i ogni lettera, numero e carattere presente sulla tastiera (e ad alcuni caratteri che 
non vi compaiono). 
Pertanto la stringa seguente: 

$var = "Ciao \x4C\x69\x7A" ; 

produrrebbe la stringa: 

Ciao Lìz 

Perché? 4C e un numa< ..-..,.1. < umili i qulvalente a 76 decimale; il carattere 76 nella 
tabella ASCII corrisponde al i iralton i 69 equivale a l()S in decimale e corrispon- 
de .il carattere T. Infine 7A equivale a MI In decimale e corrisponde al carattere 7.'. 



Stringhe heredoc 

Un altro modo per definire le stringhe implica il ricorso alla sintassi heredoc, che 
utilizza tre caratteri di minore (<«) seguiti da un identificatore. È necessario utiliz- 
zare un identificatore di chiusura per indicare la fine della stringa. Tale identificato- 
re deve utilizzare gli stessi caratteri dell'identificatore di inizio, deve iniziare alla pri- 
ma colonna della riga e dev'essere seguito immediatamente da un punto e virgola. 
Per esempio: 

<?php 

// Stringhe - Esempio 8-3 

/,/.:..,,.... ...... ...... , 

$myString = «<MST 
Questo è un esempio di stringa 
che occupa più righe 
e utilizza la sintassi heredoc 
MST; 

echo SmyString; 

La stringa heredoc si comporta esattamente come quella con virgolette doppie. 

Variabili nelle stringhe 

Le stringhe con virgolette doppie consentono di utilizzare un numero maggiore di 
sequenze di escape rispetto a quelle con virgolette singole. Perché allora non utiliz- 
zarle sempre? In effetti c'è un'altra differenza tra le due stringhe: qualunque variabi- 
le inclusa in una stringa con virgolette doppie verrà espansa. Che cosa significa? 
Considerate l'esempio che segue: 

$name = "Simone"; 
$message = "Ciao, $name"; 
$message = 'Ciao, $name'; 

Nel frammento di script precedente, la prima riga definisce una stringa con valore 
' mone " ; la seconda riga definisce una stringa con valore " Ciao , Simone " , men- 
a terza definisce una stringa con valore ' Ciao, $name 1 . Questo dipende dalla 
erenza tra stringhe a virgolette singole e a virgolette doppie. Con una stringa a 
virgolette singole la variabile (in questo caso $name) non viene riconosciuta come 
tale e viene visualizzato il testo ' $name ' ; nel caso invece di una stringa che utilizza 
le virgolette doppie, la variabile viene riconosciuta e viene sostituita con il valore 
corrente. 

E possibile assegnare a una stringa il valore di un'altra stringa utilizzando il carattere 
o operatore uguale (=). Per esempio: 

$name = "Simone"; 
SanotherName = Sname; 
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<.».i il valore della variabile Sname viene jssegnato alla variabile SanotherName 
li copiato in essa), Lo script seguente illustra l'uso delle variabili nelle stringhe: 

• /|>h|i 

// Stringhe - Esempio 8-4 
// 

I marne = 'Liz' ; 
li » 1 1 > mime = 'Hall' ; 
■oinnge = "Ciao, Sfirstname"; 
»»Biige2 = "Il tuo nome completo è Sfirstname Ssurname"; 

'i Smessage; 

io "<br />"; 
«> 'io $message2; 
•otto "<br />"; 

•Otto "Arrivederci, Sig.ra Ssurname"; 

I iwmpio precedente produce l'output illustrato nella Figura 8,1. 



T|liil|i://localhost/phpbook/esempìo8-4.php - Microsoft 
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«•Igiira 8.1 

iblll nelle stringhe. 



Dovete sapere però che le stringhe non funzionano sempre esattamente nel 
doildcrato. Considerate lo script seguente: 

Ophp 

Stringhe - Esempio 8-5 
•curroncy = "dollar"; 

ccho "The currency is the $currency<br />"; 
ocho "I would like some Scurrencys <br />"; 

|0ho "I would like some ${currency}s <br />" 

■ 



modo 



Lo script precedente genera un errore, come mostrato nella Figura 8.2. 



Ijji http://localhost/phpbook/esempio8-5.php - Microsoft Jnlerriet enpiorer 


■te' in» 


x| 
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» 


Indirizzo http://localhost/phpbook/esernpio3-5.php !V] jÌ>Vai 


Collegament 




■ : The currency is the dollar 






Notìce: Undefined variable: currencys in 

e:\inetpub\wwwroot\phpbook\esempio8-5.php online 9 

I would like some 

I would like some dollars 




' ; 

■ : 

. 


[© Operazione completata ;, « f, f linSneFtocaì? 







Figura 8.2 

Problemi con le variabili nelle stringhe. 



Il motivo di questo errore è che il computer analizza il nome della variabile della se- 
mini;! istruzione echo come $currencys e non $currency. Per risolvere il proble- 
mi! potete racchiudere il nome della variabile tra parentesi graffe { }, come nella 
tei za Istruzione echo. 



Unione di stringhe 

1 1 Ittlnghe possono essere facilmente unite o concatenate con l'operatore punto 
Poi « sciupio: 

«i lo - "Sig.ra 
iNomo - "Liz »j 
•nurNnmo - "Hall"; 
•rullNnmo ■ SfirstName . $surName; 
*t 1 1 loNamo ■ Stltle . SfirstName . SsurName; 

il frammento di codice precedente crea una stringa $fullName con valore "Liz 
I UH". < K.sei v Mie clic lo spazio tra il nome e il cognome non verrebbe incluso se non 
Ci fi >S8e un carattere di spazio alla fine della stringa "Liz ". $titleName viene creata 
Con 11 valore "Sig.ra Liz Hall". 

Possiamo anche utilizzare questo operatore nella nostra istruzione echo per visua- 
lizzare le variabili in modo più chiaro. Considerate l'esempio seguente: 

<?php 

// Stringhe - Esempio 8-6 

ih 



Stax = 17; 



oli ii igne ai 



:|.iiiìI 200; 
ScopyOfNet = &$net; 
SanotherCopy = $net; 

$net =100; 

«cho "ScopyOfNet SanotherCopy"; 
ocho "<br>"; 

ocho ScopyOfNet . " " . SanotherCopy; 
?> 

L'esempio precedente illustra come sia possibile impiegare l'operatore punto per 
unire stringhe in un'istruzione echo. < 

Accesso ai caratteri delle stringhe 

(L'accesso ai caratteri di una stringa può avvenire specificando tra parentesi graffe 
< li ipo la stringa l'offset rispetto a zero del carattere desiderato. Per esempio: 

Sname = "Liz Hall"; 

•second = $name{1}; r~. 

I .i Figura 8.3 illustra come viene memorizzata la stringa e come avviene il riferimen- 
to a essa. La variabile $second ha valore "i". 



0 


1 


2 


3 


4 


5 


6 


7 
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I 






H 


a 


I 
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Figura 8.3 

Caratteri delle stringhe. 



Nelle versioni precedenti di PHP era possibile utilizzare i caratteri [ ] invece di { }, 
Ina oggi essi non sono più validi. Lo script seguente illustra l'uso della concatena- 
zione delle stringhe e il riferimento ai caratteri: 

<?php 

// Stringhe - Esempio 8-7 
fi 

SfirstName = 'Liz ' ; 

SaurName = 'Hall' ; 

SfullName = SfirstName . SsurName; 

Ifirst = SfullName{0}; 
Isecond = SfullName{1}; 
Ithird = $fullName{2}; 
Sfourth = $fullName{3}; 
Ififth = SfullName{4}; 
Islxth » $fullNan>e{5>; 



$seventh = $f ullName{6}; 
$eighth = $f ullName{7}; 



echo "Il nome completo è ; 11 . $fullName . •<p>"; 
echo "Il primo carattere in $fullName è $f irst<br>" ; 
echo "Il secondo carattere in $fullName è $second<br>" ; 
echo "Il terzo carattere in SfullName è $third<br>" ; 
echo "Il quarto carattere in $fullName è $fourth<br>" ; 
echo "Il quinto carattere in SfullName è $fifth<br>"; 
echo "Il sesto carattere in $fullName è $sixth<br>"; 
echo "Il settimo carattere in $fullName è $seventh<br>" ; 
echo "L'ottavo carattere in SfullName è $eighth<br>" ; 

L'output prodotto dallo script precedente è illustrato nella Figura 8.4. 



Conversione di stringhe in numeri 

In alcuni casi le stringhe possono essere valutate come valori numerici. Il valore e il 
tipo numerico sono determinati nel modo indicato di seguitò. 

1. La stringa sarà valutata come valore in virgola mobile se contiene uno qua- 
lunque dei caratteri seguenti, ".», "e" o "E", altrimenti verrà valutata come 
intero. 

2. Il valore numerico sarà determinato dalla parte iniziale della stringa. Se si 
natta di un valore numerico valido verrà utilizzato, altrimenti la stringa sarà 
valutata 0. 

Lo script che segue illustra questa conversione: 
<?php 

// Stringhe • Esempio 8-8 

// 

$num • 23; 

$»trlno • "45" ; 
$mld - $num + Sstring; 
Smnlos - -3.45 maschi"; 
»r»mnlos 2 + Smales; 

odio "23 + '45' è uguale a $add<br />"; 
ocho "2 + '3.45' è uguale a $females<br />": 
7> 

L'ÒUtpUt prodotto da questo script è il seguente: 



23 + '45' è uguale a 68 
2 + '3.45' è uguale a 5.45 
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http://localhost/phpbookjesemplo8-7.php 



Il nome completo è : Liz Hall 

D primo carattere in Liz Hall è L 
H secondo carattere in Liz Hall è i 
H terzo carattere in Liz Hall è z 
H quarto carattere in Liz Hall è 
H quinto carattere in Liz Hall è H 
Il sesto carattere in Liz Hall è a 
Il settimo carattere in Liz Hall è 1 
L'ottavo carattere in Liz Hall è 1 




_ ; ! IJM.^mm^ 




Figura 8.4 t 

Riferimento a caratteri singoli in una stringa. 



Riepilogo 



Questo capitolo ha introdotto il tipo stringa, esplorando i diversi modi in cui è pos- 
sibile definire una stringa in PHP e come questi diversi tipi di stringa influiscano sul- 
lo modalità di impiego delle stringhe stesse. Abbiamo poi analizzato come unire più 
siringhe, accedere ai singoli caratteri e convertire le stringhe in numeri. Nel prossi- 
mo capitolo verrà introdotto il concetto di variabili dall'esterno di PHP. 



\ 



Capitolo 9 

Variabili PHP predefinite 



ntroduzione 



■ Jto capitolo verranno introdotte alcune variabili che vengono prodotte al di 
fon li PHP e che sono note come variabili predefinite. Si vedrà come il server 
ambiente del sistema e i moduli HTML generano Variabili cui è possibile (e 
•» molti casi necessario) accedere. Le variabili predefinite sono disponibili per 
Duiilunciue script, ma poiché molte di esse dipendono dalla piattaforma e dal server 
W ... uso, e certamente difficile documentarle tutte. Inizeremo illustrando un 
" ", • , . mcn ° dl . fond ? evenuto in PHP a partire dalla versione 4.2 e che influisce 
-i. v . -Imente sul modo m cui avviene l'accesso a queste variabili predefinite. 

Direttiva register_globals 

! '"'T' Óa [ r " a f io , della versione 4-2.0, PHP viene distribuito con la direttiva 
- s ter globals (situata nel file php.ini) impostata su off. Ciò significa che le 
4 ^ at've 'i moduli, server, cookie e così via non vengono più registrate 

k- vanab.1, g obah. Per PHP si tratta di un cambiamento di grand? importanza 
7' i r ««teyolmente la sicure^ degli script. Ciò significa, tuttavia che gli 

111 lea , llZ2atl P r ' ma del| a versione 4.2,0 non funzioneranno correttamente le 

•■. uiiono la nuova forma di accesso alle variabili predefinite (come avviene ne- 
Nli rsi-mp. di questo libro) oppure se non si imposta su on la direttiva 
• »U i h t er_globals nel file php.ini (soluzione sconsigliata). 

Funzione phpinfo() 

E «nc'ude una funzione molto utile chiamata phpinfo(), che visualizza una 
"'«■ M"anuia eli informazioni sullo stato corrente di PHP, tra cui le opzioni di 
l 'i illazione attivate, le estensioni attivate e le variabili predefinite disponibili Nel 
irò caso e particolarmente utile, in quanto verranno visualizzate tutte le variabili 
1 '"ine definite dal sistema, 
rilassi della funzione è la seguente. 

MI i>npinfo(int opzione); 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome Tipo Descrizione 



opzione 


Int 


" : — _ 

Opzioni di configurazione, valori. 
(1,2, 4, 8, 16, 32, 64 e -i): 

1 informazioni generali; 

2 crediti di PHP; 

4 configurazione (direttive PHP impostate nel fi- 
le php.ini); 
8 moduli caricati; 
16 variabili d'ambiente; 
32 variabili predefinite; 
64 informazioni sulla licenza; 
-1 tutte le precedenti; è l'impostazione predefi- 
nita se non viene incluso alcun valore. 


Restituzione di phpinf o 


Int 


Restituisce TRUE se riesce o FALSE se si verifica 
un errore. 



Esempio di funzione: 



phpinf o(32); 

1." script seguente illustra l'utilizzo di questa funzione: 
<?php 

// Variabili predefinite - Esempio 9-1 
// 

phplnfo(32) ; 

L'OUtpUt di questo i script è illustrato nella Figura 9.1. 

Variabili del server 

' •«• » :iri:.l ni, , ld server sono quelle impostate dal server Web. Poiché il server Web di 
i um un produttore è un prodotto sostanzialmente diverso dagli altri, non c'è alcuna 
garanxu, che tutu ■ server Web forniscano queste variabili, anche se la maggior par- 
ie; di csN, ne rornira almeno qualcuna. La Tabella 9.1 elenca le variabili del server 
più comuni e una descrizione del loro contenuto. 

Le variabili del server (come tutte le variabili predefinite descritte in questo capito- 
lo) sono memorizzate in un array predefinito. Nel Capitolo 14 imparerete a creare i 

SS £ P f r Ìl m0ment ° dOV£te Veemente capire come si accede alle 
..rubli ipredefrmte memorizzate in un array. Per accedere alle variabili del server 

SS ?J$5$S H n T e di ar f y $ - SER ^ ER seguito da una C °PP ia di P arentesi qua- 

dr che lacchiude tra virgolette singole il nome della variabile predefinita. Per 
Script mmSnt ° S6gUente memorizza il nome dello script nella variabile 

Sscript = $_SERVER[ 'PHP_SELF' ] ; 
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PHP Variables 




.SERVER|"C0NTENT_LENGTH"1 



.SERVER 

|"GATEWAYJNTERFACE") 



.SERVER["HTTPS"J 



SERVER["HTTP_ACCEPH 



SERVER 

"HTTP_ACCEPT_LANGUAGE"] 



SERVE R|"HTTP_CONNECTION" 



_SERVER|"HTTP_HOST") 



SIRVER|"HTTP_USER_AGENT" 



E:\WVINN"rasystem32«cmd.exe 



0 



COKI .1 



itnagefgif, Imagèft-xbitmapi imageflpeg, imageJpIpag, 
application/vncf.rns-powerpoinl, appliCationAincl.tJiè-excBl, 
application/msword, T f 



It 



Keep-Allve 



ocamost 



MozillaM.O (compatire; MSIE 6.0; Windows NT 5.0) 



IH Operatone completata ^B^^Mip MH|W| 

ri B ura 9.1 

ii it di phpinfoQ. 
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Tabellari 



Variabili del server 



Variabile 



Descrizione 



•PHP_SELF' 

"OATEWAY_INTERFACE ' 
'■I HVER_NAME' 
' BGRVER_SOFTWARES ' 

'8ERVER_PR0T0C0L' 

' REQUEST_METHOD 1 

'QUERY_STRING' 
D0CUMENT_R00T' 

■HTTP_REFERER' 

"HTTP USER AGENT ' 



Il nome di file dello script corrente relativo alla directory root dei 
documenti. Verrà utilizzata in molti script proposti più avanti nel 
prosieguo del libro, laddove verranno introdotti i moduli e sarà 
necessario fare riferimento allo script medesimo. 
La versione dell'interfaccia CGI in uso. 
Il nome del server host. 

Stringa di identificazione del server che viene passata nelle inte- 
stazioni HTML quando risponde alle richieste. 
Nome e versione del protocollo di informazioni con il quale la 
pagina è stata richiesta. 

Il metodo di richiesta utilizzato per accedere alla pagina, ossia 
'POST 1 . 

La stringa di query (se presente) utilizzata nell'accesso alla pagina. 
Il file root dei documenti, definito nel file di configurazione del 
server. 

L'indirizzo della pagina Web che ha portato l'agente utente 

(browser Web) alla pagina corrente. 

l.'inicMa/.ìone dell'ag ente utente dir accede alla pagina. 

iSagus) 



Tabella 9.1 (Continuo) Va riabili dal larvar 

Varlablle Descrizione 

1 REMOTE_ADDR 1 



' REMOTE~PORT ' ffS*??, J * ^»»*f* visualizza la pagina] 

; s S Er"e P R T -POR L T NAME ' !' PerCOrS ° , aSSOk,t0 de "° *■* cocente. 

' script-naSe ■ SpS^dS dal f S,Ver per ]e comun ^9ni. 

'PHP Al ITU iiqpd- J PtrcoKso dello script corrente. 

' PHPaS" * «ver Web Apache fornito dall'utente. 

1 PHP-AUTH-TYPE ' Tìnn H t f 1 SerVCr Web Apache fomita dall'utente. 
— — ^ T.po di auten ticazione HTTP del server Web Apache. 

La Tabella 9.1 illustra il contenuto di alcune di queste variabili 
L output prodotto dallo script seguente è iUuslZ^M^ 9 .2. 
<?php 

'/ / ^ ariabni P^definite - Esempio 9-2 

T° 7HP-SELF: » .S.SERVERf'PHP SELF' ] ; 

*K P >SERVER -NAME ; » . $ SERVER[ SERVER NAME'T 

echo »<br />SCRIPT_NAME: » . $ _ SERVER [ . SCR ^% P ^, j | 



?> 



Jlillli^V'Iocalhost/phpbook/'i 



t l S-'' / Z l g? lhost ^ h P bo °K'esempio9-2.phD 



PHP_SELF: /phpbook/esemp t o9-2.php 
SERVER_NAME: localhost 
SERVER_SOFTWARE: Microsoft-DS/5 0 
SERVER_PROTOCOL: HTTP/1 1 

sasr- *— ™ 5.o, 

SERVER_ì>ORT: 80 

SCRIPT_NAME: /ph P book/ es e mpl o9-2.php 





! Intranet locale 



Figura 9.2 

Le variabili predofmlto del larvar. 



i 
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Variabili d'ambiente 

Le, variabili d'ambiente vengono messe a disposizione di PHP dal sistema operativo 
bl quale ■ » esegue PHP. Questo è il motivo per cui sarebbe molto difficile E 
• I. noe 'definitivo, m quanto i sistemi operativi e le shell sotto cui PHP opera sono 
fcolti. La funz.one phpinfo{ ) consente di ottenere un utile elenco delle funzioni 

^^y^^l^?™ di PHR La Tabella 9-2 fornisce des Son 
di alcune d: queste variabili nell'ambito di un'installazione di PHP in Windows XP. 



Tabella 9.2 Variabili d'ambiente 



Variabile 


Descrizione 


1 COMPUTERNAME ' 


Il nome del computer. 


1 HTTP_H0ST ' 


L'indirizzo del server Web (localhost è quello più comune 




per gli ambienti di sviluppo). 


' HTTP_USER_AGENT ' 


La stringa di identificazione del browser Web. 


' L0CAL_ADDR ' 


L'URL del computer locale. 


'NUMBER OF PROCESSORS' 


Il numero di processori. 


'OS' 


Il sistema operativo. 


■Patir 


Il percorso del sistema operativo. 


'PATH_INF0' 


Il percorso dello script corrente a partire dalla directory root 




degli script. ' 


' PATH_TRANSLATED ' 


Il percorso completo dello script corrente. 


'PROCESSOR IDENTIFIER ' 


La stringa di identificazione del processore. 


'SERVER SOFTWARE ' 


La su-inga di identificazione del server Web 



Per accedere alle variabili del server viene utilizzato il nome di array $ ENV seguito 

^Z?Set% r T SÌ qUadre - raCChÌUde tfa VÌrS ° lette ^gole il nomedella 
\ .maone predelinita. Per esempio: 

Sos = $_ENV[ 'S' ] ; 

Questa istruzione memorizza il sistema operativo nella variabile $os Lo scrini se- 
guente illustra il contenuto di alcune di queste variabili: P 

<?php 

// Variabili predefinite - Esempio 9-3 

m- 

OCho " COMPUTERNAME : » . $_ENV[ 'COMPUTERNAME' 1 ; 

echo »<br />HTTP_H0ST: » . $_ENV['HTTP HOST'l; 

echo »<br />HTTP_USER_AGENT: « . $_ENV['HTTP USER AGENT'l- 

echo »<br />LOCAL_ADDR: " . $ ENV[~L0CAL ADDR' 1 • 

ss -z ;:Ss- BER : % : iz E ifu " ■ •-^•^w^sbors.,,. 

echo "<br />Path: " . $ I NVI 'l'utn ' | ; 

echo "<br />PATH_INF0: • , | INV|'PATH INFO']- 

echo »<br / >PATH_TRAN8LATI0 1 • . I fjNV| ' PATH TRANSLATED ' 1 ; 

echo <br />PROCESSOR_II)INH. .... I , fNvf PROCESSOR IDENTIFIER 1 1 • 

echo "<br />SERVER_SOFTWAi„ | •lV|~||RVER SOFTWARE'] 



L'output prodotto dallo scrft precedente è illustrato nelfc Figura 9.3. 



File Modifica Visualizza Preferiti . Strumenti 



Indietro » 


- é l à j ^Cerca ^Preferiti 






Indirizzo ■ jjgj http:// 


ocalhost/phpbook/esempi 0 9-3.php 







COMPUTEENAME: ARCIDZ 
HITP_HOST:locàlhost 

SSSffi^ dM -° Ccorapatible; MSIE 60; ™ ows OT 5o > 

NTJMBER_OF_PROCESS0RS: 1 
OS: Windows_NT 

PATHJNFO: /phpbook/esempio9-3.php 



Figura 9.3 

Variabili di ambiente predefinite. 



Variabili dei moduli 

monzzati in un array chiamato $ POST e l'accesso a pssì ~-„;± ■ feUX,u lu f 
variabili del server. Per esempio P ° 4VVenue Come P er le 

SformField = $_P0ST [ •formField' ] ; 

Ìtìd?ùn modulo^' [ \ PaSSa ? SÌ °, ^ ^ PUÒ awenire anche con " «lo GET I 

35^3ffl§f^S^! 11 metodo GET possono S$$^ accedendo 

$dataField = $_GET[ 'dataField 1 ] ; 

Gli esempi del libro utilizzeranno soltanto il metodo POST. 



yi cucinine a/ 



Variabili di sessione 

tll ™ Verranno introc,ott « «■ feloni e sarà fornita una spiegazione di 
.ino essere insegate per fornire una pagina Web personalizzata a livello 
pei ciascun utenic Web. I.c variabili memorizzate per ciascun utente 

i ^ m J£&"*** e a esse è possibii? — *g 

• •»..ta - $_SESSION['sessData']; 



•riabili dei cookie 

« ipllolo 22 si parlerà dei cookie e si vedrà come possano essere utilizzati per 
"E ' daCl , d '. u ; "teme specifico a livello locale sul computer def enent 
0 .me variabili dei cookie può avvenire attraverso l'array $_COOKIE. Per 

Il 1 

ioData = $_COOKIE[ 'cookieData']; 



Costrutto isset() 



■ ■ includere il capitolo vale la pena di menzionare il costrutto isset ( ) che 

ut, .zzato per controllare se una variabile è stata o meno impostata 
il della funzione è la seguente. 

lMot(mixed variabile) 
bbrilii seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Tipo 



Descrizione 



'■min Ir Mjxed 

ghiaione di isset ( ) bool 



La variabile da controllare. 

TRUE se la variabile è impostata, FALSE se non lo è. 



r.. mino «li l'unzione: 

• ($ ENVf'OS']); 

' ■ < isi rutto verrà utilizzato insieme al costrutto if nei capitoli successivi per 
nnre se alcune variabili predefinite sono state o meno impostate, in modo 
ne la generazione d, messaggi di errore nel caso in cui si cercasse di accede 
1» • limi variabile che non è impostata. Per esempio: 

// variabili predefinite • Esempio 9-4 

•<br />QUERY_STRING: " . $_8ERVER( 'QUERY_STRING ' ] ; 



Lo script precedente dovrebbe restituire un avviso come il seguente: 

Notice: Undefined index: QUERY_STRING in 
c:\inetpub\wwwroot\phpbook\esempio9-4.php on line 6 

QUERY_STRING: 

^avanti vedremo come sia possibile utilizzare isset() per evitare questo mes- 

Riepilogo 

UiieMo capitolo ha presentato i diversi tipi di variabili predefìnite disponibili in 
' ' , '" "" ' state analizzate tutte in modo approfondito, in quanto verranno in- 
'I' "'' ili in. iii.c-nio opportuno nei capitoli successivi. Tuttavia è importante osser- 
'!<' ihl ilaini , utilizzato solo la forma sicura delle variabili predefinite introdotta 

' 1.^.0 di PI IP, dove le variabili globali non sono registrate per un ac- 

■ Klolialc fomento del prossimo capitolo saranno espressioni, operandi e 

• >|H'l.lll Hi ^ 



Capitolo 10 

Espressioni, operandi 
e operatori 



Introduzione 

li i capitoli precedenti sono stati esaminati i vari tipi di variabili; ora, invece, l'atten- 
||i me vena rivolta ai modi per manipolare le informazioni contenute in esse con 
I Introduzione dei concetti di espressioni, operandi e operatori. Le espressioni ven- 
gono utilizzate per calcolare un risultato che implica diversi operandi (variabili o 
ioitanti); gli operatori consentono di manipolare le variabili e le costanti nelle 
I i Mi ssioni; gli operandi sono le costanti o le variabili su cui agiscono gli operatori. 

Espressioni 

K^HVtVi ' . ... "'..li- 1 7/ h ' ■ • ■ 

in pr< >grammazione, un'espressione è un elemento che esprime un valore. Quest'ul- 
<mi< » P L| ò essere un semplice valore, ossia un singolo operando che esprime un sin- 
i valore: 



*T#8tO" 

Iplace 

• 'l 'i une un insieme di operandi che vengono combinati tramite operatori: 



I + 7 + 15, 

'il significato della" . "vita" 
'Benvenuti a " . $place 



mi} m>i 



' .li operandi di un'espressione possono essere variabili, costanti o altre sottoespres- 
lioni. La Figura 10.1 illustra la differenza tra operandi, operatori ed espressioni in 
due semplici esempi. 
Beco una semplice espressione: 

•var =5; 



QUI alla variabile $var viene assegnato il valore costante 5. In questo esempio 5 è 
' espressione. 



Figura 10.1 

Operandi, operatori ed espressioni. 

Sonni- un altro esempio: 
•var ■ $var2; 

in ■ |w.".i( ) caso a $var viene assegnato il valore di $var2. In questo esempio $var2 
• l'espressione, 

1 i inali lente ora l'espressione seguente: 
•v«r • B + 3 + 2; 

i ■ iprcssii ine 5 + 3 + 2 è costituita da due operatori e tre operandi e non presenta 
pattl< olarl difficoltà di comprensione, in quanto le variabili 5, 3 e 2 vengono som- 
male e il risultato 10 viene memorizzato in $var. Vediamo tuttavia cosa accade se 
Utilizziamo un operatore - (meno) invece dell'operatore +: 

•var -5-3-2; 

(.Hir.sla espressione significa forse sottrarre 3 da 5, che dà 2, e poi sottrarre 2 da 
questo, ottenendo 0? Oppure significa che 2 verrà sottratto da 3, ottenendo 1, che 
poi verrà sottratto da 5, con risultato finale 4? Fortunatamente è possibile utilizzare 
le parentesi per chiarire come dev'essere intesa l'espressione: 

$var = (5 - 3) - 2; 
$var = 5 - (3-2); 

Più avanti nel capitolo verrà esaminato l'ordine in cui vengono valutate le espres- 
sioni. 

- 

Operatori 

Gli operatori consentono di manipolare le variabili e le costanti, o di "operare" su di 
esse, e benché probabilmente li conosciate già, potreste non averli mal sentiti ' Inu- 
mare con il termine di operatori. Gli operatori più noti saranno quelli pel le i ipera- 
zioni matematiche di addizione < + ), sottrazione (-), divisione (/) e mnlllplklixione 



operatori 
k 

v operandi 




$var2 = (34 - $pi) * 2; 



-i 



sottoespressione 



espressione 



Impressioni, operanoi e operatori / i 



C), Gli operatori vengono descritti «Dine unari, binari o ternari secondo la loro ca- 
pa< ùa di accettare uno, due o tre operandi (argomenti). Gli operatori più, meno, 
moltiplicazione e divisione sono tutti operatori binari. 



Operandi 



Un operando non è altro che un elemento sul quale un operatore lavora. In 
un'espressione come 34 - Spi, un operando è una costante (34), mentre l'altro è 
Ka variabile ($ pi). 

Operatori aritmetici 

l'I II' supporta cinque diversi operatori aritmetici, elencati nella Tabella 10.1. 
Tabella 1 0. 1 Operatori aritmetici , 



Nome 


Operatore 


Esempio 


Descrizione 


Addizione 




'$a + $b 


Somma $a e $b. 


s> ittrazione 




$a - $b 


Sottrae $b da $a. 


Mi iliiplicazione 


• ■* 


$a * $b 


Moltiplica $a e $b. 


i ih telone 




$a/$b 


Divide $a per $b, 


Mi ululo 


% 


$a % $b 


Resto della divisione di $a per $b. 



l i i script che segue offre un esempio di utilizzo degli operatori aritmetici; 



<?php 

// Espressioni - Esempio 10 -1 
// 



$a = 5; 
•b = 3; 

ocho 'a + b = 
ocho 'a - b = 
ocho 'a * b = 
ocho 'a/b = ' 
ocho 'a % b = 

?> 



. ($a + $b) . '<br>' ; 
. ($a - $b) . '<br>' ; 
. ($a * $b) . '<br>' ; 
($a/$b) . ' <br> ' ; 
. ($a % $b) . '<br>'; 



La Figura 10.2 illustra l'output prodotto da questo script. 

Osseivate che nell'esempio l'operatore % restituisce il resto della divisione di 

3, ossia 2. 



5 per 



Operatori di assegnamento 

La descrizione delle espressioni fornita In precedenza è oltremodo semplificata. Il 
Segno di uguale (-) in l'Ili' è un opi-r.imre di perse, l'operatore ili assegnamento, 




Figura 10.2 

Utilizzo degli operatori aritmetici, 

he agisce impostando l'operando alla sua sinistra al valore dell'operando posto 
lullo destra. Ciò significa che $a = 5 + 3, per esempio, costituisce un'espressione 

" 1 ipli-sso (non solo la parte alla destra di "=", quindi). La Figura 10.3 illustra 

quanto appena affermato. 



operatori 



operandi 




$var2 = (34 - $pi) * 2; 



_^ 

sottoespressione 

i y 

sottoespressione 



espressione 



Figura 10.3 

Un'espressione completa. 



espressioni, operanai e operatori is 



[Jori dovete considerare "-" (dine un carattere di "uguale a", poiché in realtà do- 
rrebbe essere letto come carattere "assegna a". L'uso più semplice dell'operatore di 
Mjsegnamento è il seguente: 

ivar = 56; 

Questa istruzione significa "il valore 56 viene assegnato alla variabile $var". Ecco 
ira un esempio un po' più complesso: 

|var = $a = $b; 

Questa riga significa che il valore contenuto in $b viene assegnato a $a, che a sua 
1 1 ilta viene assegnata a $var. PHP supporta anche i seguenti "operatori combinati": 

•• - 3; 

In «s 4< 

lb ■ "Salve "; 

lb .= "a tutti!"; 
I'- 

1 1 prima riga assegna il valore 3 alla variabile $a. 
•a - 3; r 

I .i seconda riga assegna il valore 7 a $a proprio come se fosse stato scritto: 
lo $a + 4; 

I i terza e la quarta riga producono il valore "Salve a tutti! " assegnalo $b, che 
| i juivale a scrivere: 



lb ■ "Salve "; 

•b - $b . "a tutti!"; 



I ,i f< urna dell'operatore di assegnamento non ha importanza; scegliete quello che 
1 1 1 ivate più comodo. 



Operatori di manipolazione dei bit 



i .li operatori di manipolazione dei bit, noti anche come operatori bit per bit, con- 
sentono di commutare daOaledalaOi singoli bit di un intero. Considerate per 
Uempio le seguenti espressioni: 



la - 31; 
lb - 12; 

lo ■ Sa & $b; 

Con queste espressioni il valore 12 verrà assegnato alla variabile $c, in quanto 
l < iperatore & effettua un'operazione AND dei bit del primo intero con quelli del se- 
• i nido. Per comprendere il funzionamento di questo meccanismo, è necessario ca- 
I un- come avviene la memorizzazione degli interi sotto forma di numeri binari in un 
i omputer. Considerate la Figura IO. 4, ehi- illustra come vengono rappresentati i due 
numeri M e li nella notazione binaria ,i H hit. 









31 = 
12 = 
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1 
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Figura 10.4 

Memorizzazione degli interi come numeri binari. 



Quando si effettua un'operazione AND su questi due numeri, solo i bit che sono 1 
in entrambi i numeri vengono lasciati tali, mentre tutti gli altri vengono impostati a 
0. La Figura 10.5 illustra quanto appena affermato. 





128 


64 


32 


16 


8 


4 


2 


1 


31 = 


0 


0 


0 


1 


1 


1 


1 


1 






















128 


64 


32 


16 


8 


4 


2 


1 


12 = 
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31 & 12 = 


.0' 


0 


0 


0 


1 


1 


0 


0 



Piglili 1 0.5 

Operazione AND tra due numeri. 

Quando si effettua un'operazione AND con gli interi 31 e 12, si ottiene il valore 12. 
La Tabella 10.2 elenca gli operatori di manipolazione dei bit disponibili in PHP. 



Tabella 1 0.2 Operatori di manipolazione dei bit 



Operatore 


Esempio 


Descrizione 


& 


$a & $b; 


Imposta ì bit a 1 quando i bit in entrambi gli operandi 






sono 1. 


i 
i 


$a ! $b; 


Imposta i bit a 1 quando uno dei bit in entrambi gli ope- 






randi è 1. 


l\ 


$a /\ $b; 


Imposta i bit a 1 quando uno dei bit negli operandi 6 1. 






ma non entnimbi. 



operatore 






« 


$a « $b; 


Sposta a sinistra i bit. 




$a » $b; 


Sposta a destra i bit. 


AND 


$a AND $b; 


Imposta i bit a 1 quando i bit in entrambi gli operandi 






sono 1. 


on 


$a OR $b; 


Imposta i bit a 1 quando uno dei bit in entrambi gli ope- 






randi è 1. 


Pilli 

A Un 


Sìa X0R $b; 


lmnn«w i hit a 1 mitiriHo uno Hpi hit npfli ooerandi è 1. 


/ 


I 


ma non entrambi. 



I operatore di shift a sinistra "«" sposta a sinistra i bit nell'operando e imposta a 
/. in tutti i bit vacanti. Ogni spostamento a sinistra ha lo stesso effetto di una molti- 
plicazione per due dell'operando. Lo shift a destra "»" sposta a destra i bit 
I iell'< iperando e imposta a zero tutti i bit vacanti. Ogni spostamento a destra equiva- 
li ,i una divisione per due. Lo script che segue dimostra l'utilizzo degli operatori di 
iii.mipolazione dei bit: 

•?php 

// Espressioni - Esempio 10-2 
// 

OCho "(7 & 2) = " . (7 & 2) . '<br>' ; 

OChO "(7 | 2) = " . (7 | 2) . '<br>'; 

ocho "(7 A 2) = " . (7 A 2) . '<br>' ; 

ccho "(2 « 2) = " . (2 « 2) . '<br>'; 

ocho "2 » 1) = " • (2 » 1); 
?> 

I ,i I igura 10.6 illustra l'output/prodotto dallo script precedente. 
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Figura 10.6 

Uso degli operatori di manipolazione dei bit. 



Operatori di confronto 



Gli operatori di confronto vengono utilizzati per confrontare espressioni dal punto 
di vista logico e aritmetico. 

Nella maggior parte dei casi sono impiegati nel flusso delle istruzioni di controllo 
clae verranno trattate nel Capitolo 8. La Tabella 10.3 illustra gli operatori di confron- 
to supportati da PHP. 



Tabella 10.3 


Operatori di confronto 




Operatore 


Esempio 


Descrizione 


== 


$a == $b 


Uguale. 


=== 


$a === $b 


Identico. 




Sa 1= $b 


Non uguale. 




Sa !== $b 


Non identico. 


< 


Sa < $b 


Minore di. 


> 


Sa > $b 


Maggiore di. 


>= 


Sa >= $b 


Maggiore o uguale a. 


<= 


$a <= $b 


Minore o uguale a. 



La differenza tra gli operatori uguale e identico è che gli operatori di uguale e non 
uguale controllano se i valori dei due operandi sono gli stessi; con gli operatori di 
identico, invece, viene verificato anche il tipo degli operandi (oltre al valore) per 
vedere se sono o meno identici. 



Operatore condizionale 

PHP supporta un "operatore condizionale". 

si tratta di un operatore ternario, in quanto richiede tre operandi, e ha la sintassi se- 
guente: 

(esprl) ? (espr-2) : (espr3); 

Questo operatore esprime il valore di espr2 se esprl è vera, altrimenti esprime il 
valore di espr3. Per esempio: 

SstockString = (Sstock >0) ? "Disponibile " : "Esaurito. 11 

In questo caso, se $stock è maggiore di 0, alla variabile SstockString viene asse- 
gnato il valore "Disponibile", altrimenti le viene assegnato "Esaurito". 

Operatori di incremento e decremento 

: 

PHP supporta le forme prefissa e suffissa degli operatori di incremento e decremen- 
to, elencate nella Tabella 10.4. 



, upui tu iui t mwi i 



Tabella 10.4 Qpci.Unn .!> »h .wmwn.. « -lm .nmrnt» 



Nome 


1 


Dwcrlzlone 


Incremento prefisso 


..$] 


Incrementa Si di 1, quindi restituisce $i. 


Incremento suffisso 


$i++ 


Restituisce Si e quindi incrementa Si di 1 . 


Decremento prefisso 


-Si 


Decrementa Si di 1 , quindi restituisce $i. 


Decremento suffisso 


$i~ 


Restituisce Si e quindi decrementa Si di 1 . 



Il' frammento di script seguente illustra l'utilizzo di questi operatori: 

Si = 3; // assegna 3 a i 
$i++; // i viene incrementata a 4 
++$i; // i viene incrementata a 5 
Si — ; // .i viene decrementata a 4 
— Si; Ili viene decrementata a 3 

Nel frammento di script precedente non si nota alcuna differenza tra le forme pre- 
fissa e suffissa degli operatori. La differenza appare più chiara quando l'operatore di 
incremento o decremento viene utilizzato in un'espressione di assegnamento. Con- 
siderate il frammento seguente: 

Sa = 5; // ad a viene assegnato il valore 5 

$b = ++$a; Ila viene incrementata e poi assegnata a b 

$b = $a++; //a viene assegnata a b e poi incrementata 

Il risultato di questi assegnamenti è che b = 6 e a = 7. Lo script che segue illustra 
l'utilizzo di questi operatori: 

<?php 

// Espressioni - Esempio 10-3 

Si =3; 
$] =0; 

$i++; 

echo Si . '<br>' ; 
++ $i; 

echo $i . '<br>' ; 
Si— ; 

echo Si . '<br> ' ; 
-Si; 

echo Si . '<br>' ; 
$j = ++$i; 

echo '$i = 1 . Si . ' e j = 1 . $j . '<br>'; 
$] = $i++; 

echo 'i = ' . Si . ' e j = 1 . $j ; 

La Figura 10.7 illustra l'output prudono dallo script precedente. Osservate che i va- 
lori di $i e $j sono diversi quando vengono utilizzate la forma prefissa e suffissa 
degli operatori. 
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Figura 10.7 

Utilizzo degli operatori di incremento e decremento. 



Operatori logici 

l'I ir nipporta diversi operatori logici, elencati nella Tabella 10.5. Prestate attenzio- 
ni l non o infónderli con gli operatori bit per bit che portano lo stesso nome ma 
ni non intrattengono alcuna relazione. 



Tabella I0.S 


Operatori logici 




Operatore 


Esempio 


Descrizione 


And 

Or 

Xor 

NOt 
And 
Or 


$a and $b 
$a or $b 
$a xor $b 

|$a 

$a&&$b 
Sa ! ! $b 


Vero se $a e $b sono entrambe vere. 
Vero se sono vere $a o $b. 

Vero se Sa o $b sono vere, ma falso se sono vere en- 
trambe. 

Vero se $a non è vera. 

Vero se $a e $b sono entrambe vere. 

Vero se sono vere $a o $b. 



Ci li operatori logici sono utilizzati per combinare i risultati degli operatori di con- 
fronto secondo le regole dell'algebra booleana. In PHP un valore 0 viene utilizzato 
per rappresentare una condizione logica di falsità, mentre il valore 1 indica una 
condizione logica di verità. 

La presenza di due operatori And e Or (AND, &&, OR, j J ) nella tabella è dovuta alla 
priorità degli operatoli, di cui ci occuperemo tra breve. Lo script seguente illustra 
l'utilizzo di questi operatori logici: 

<7php 

// Espressioni - Esempio 10-4 

// 



«Oho ((Si < Sì) I! (Si > 5)) . '<br>'; 
|j ho ((Si < $j) && ($j > 5)) . '<br>' ; 
cedo (Si < Si) xor (Si > 5) ; 



?» 

Priorità degli operatori 

. mando un'espressione contiene più di un operatore e l'ordine di elaborazione non 
■nato chiarito con il ricorso alle parentesi, il parser decide come verrà valutata 
I espressione in base alla tabella delle priorità degli operatori, illustrata nella Tabella 
|0.6, che elenca tutti gli operatori in ordine di prorità dal maggiore (ossia gli opera- 
: I elaborati per primi) al minore. Alcuni operatori hanno lo stesso ordine di priori- 
■ appaiono sulla stessa riga della tabella. In questi casi è indicata l'associatività di 
liii'sti operatori, da destra a sinistra o da sinistra a destra, per capire se vengono 
. labi irati a partire dalla parte sinistra o da quella destra dell'espressione. 

Tabella 1 0.6 Priorità degli operatori . 

Aiiociatività Operatore 

l |>u destra a sinistra 
lestra a sinistra 

l In sinistra a destra 

Ili sinistra a destra 

Ni hi associativi 
associativi 

1 1 1 sinistra a destra 

I ).i sinistra a destra 

l in sinistra a destra 
l |)u sinistra a destra 
| Dii sinistra a destra 

I In sinistra a destra 

I In sinistra a destra 

I tu destra a sinistra 

1 1» sinistra a destra 

D.i sinistra a destra 
| l)n sinistra a destra 

Dei sinistra a destra 



i i insiderete un'espressione come la seguente: 
|a • $b + Se 

i v„i verrebbe valutata come segue: 
da * $b) + Se 



.1 

H 



/ 

+\- 



«Y »= 
& 



&& 



?: 

= += .= *- 
print 
and 
xor 
or 



= .= &= 



in quante^ l'operatore "*" è più in alto nella tabella delle precedenze, mentre invece: 
$a/$b * $c 

benché gli operatori abbiano il medesimo ordine di priorità, verrebbe valutata nel 
modo seguente: 

($a/$b) * $c 

Ciò avviene perché l'associatività degli operatori è da sinistra a destra. 

Riepilogo 

In questo capitolo sono stati analizzati in modo approfondito espressioni, operandi 
e operatori. Nel prossimo capitolo verrà introdotta l'istruzione if e il suo ruolo di 
controllo del flusso dello script, che consente di stabilire quali istruzioni devono es- 
sere eseguite. 



Capitolo 1 1 

Costrutti if e switch 



L 



Introduzione 

In questo capitolo verrà introdotto il costrutto if . Tutti i linguaggi di programma- 
zione utilizzano una forma dell'istruzione if per creare condizioni logiche. PHP 
Supporta diverse forme dell'istruzione if , delle quali ci occuperemo in queste pagi- 
ne. Verrà inoltre introdotta l'istruzione switch, che equivale a una struttura if 
complessa. 

Istruzione if di base 

Un'istruzione if di base ha una struttura molto semplice, riportata di seguito: 

if {condizione) 
I 

istruzioni da eseguire se la condizione è vera 



l.a parola "if" è seguita da una coppia di parentesi che contengono l'espressione 
Condizionale che verrà valutata dopo aver raggiunto il costrutto if . Se la condizio- 
ne è vera, le istruzioni comprese tra le parentesi graffe verranno eseguite, altrimenti 
il programma passerà oltre ignorandole. 

Vediamo un esempio di costrutto if reale. Supponete di avere due colori e di chie- 
dere a un utente di indicare quello che pensa essere il vostro preferito. Se la rispo- 
sa corretta è il rosso, una semplice struttura di istruzione if per questo esempio 
Opparirà come segue: 



<?php 

// Istruzioni if - Esempio 11-1 

W[ 

$colour = "rosso"; 

if ($colour == "rosso") 

echo "Il colore è il rosso"; 





■§;'>'' ' ■■'»-■■» ^ttnHP 

?>, , .' ,!.. .... jr ; . : ^ , _ 

Osservate che, per far funzionare l'esempio precedente, la variabile Scolour = 
" rosso" è stata impostata in modo che la condizione if sia sempre vera. Se avete 
una sola istaizione che desiderate eseguire quando l'istruzione if è vera, potete 
omettere le parentesi graffe. Per esempio: 

<?php 

// Istruzioni if - Esempio 11-2 
// 

Scolour = "rosso" ; 

if ($colour == "rosso") 

echo "Il colore è il rosso"; 

?> . , . • ',»■ ■' ; : !:Vv,: .■: ; ^'^^^.:v.^i^ : ••;i ; ;^.^"■■^^.■ -ii '^/g.^'^P v'.'y * f ;r^*g : ^7.? 

Possiamo anche modificare nuovamente lo script in modo che visualizzi il valore di 
Scolour. A tal fine è sufficiente cambiare l'istruzione echo in modo che visualizzi il 
valoiv di $colour. Possiamo inoltre modificare l'espressione if nel modo seguente: 

if (Scolour) 

Questa istruzione ora significa "se $colour contiene un valore diverso da zero". 
Nel neutro caso il valore "rosso" significherà che la condizione verrà valutata vera, 
in i |uanti ) una stringa non nulla viene valutata 1. Ecco lo script completo: 

// Iutruzioni if - Esempio 11-3 

loolour = "rosso"; 

if (Scolour) 

echo "Il colore è il Scolour"; 



?> 



Operatori 

.'• r,'., ■•■■■'■■■)..■ :. :■' in:. a, ,-;i.fj;'in«- i i'^'-iv"^ inaisi '■■ tu. V.v. iSi 

I vari operatori di confronto e logici sono stati presentati nel Capitolo 10. Con l'in- 
troduzione dell'istruzione if disponete, ora, dei mezzi per utilizzarli in modo signi- 
ficativo. 

II frammento di script che segue illustra un'istruzione if con l'operatore logico di 
uguale (==): 

if ($a == 1) 
{ 

echo "VERO" ; 




Il frammento precedente valuta M II vAfttbUe $a è impostata a 1, e in tal caso visua- 
li/./;! la parola "VERO", Se la variabile Sa è- impostata a qualunque altro valore, non 
Mira visualizzato alcunché. Il frammento di script seguente illustra l'utilizzo 
dell'operatore di non uguale (I =): 

if (Sa != 1) 

echo "FALSO" ; 

) 

In questo esempio, se la variabile Sa è impostata a 1, non verrà visualizzato alcun- 

, Ir-, mentre se è impostata su un qualunque valore diverso da 1, verrà visualizzato 

il lesto " FALSO" . È possibile utilizzare una combinazione di operatori di confronto e 

Il iglci per creare istruzioni complesse. Alcuni esempi sono elencati di seguito. 

If ($a == 1 or $a == 2){ istruzione } 

il (Sa == $b and Se == d){ istruzione } 

if($a == Sb and $c == d) [istruzione } 

lf($a != $b and $c < 5){ istruzione } 

lf(($a == Sb and Se == $d) or (Se < $f)){ istruzione } 

lf(($a == Sb and $c == $d) or (Se < $f or Se === $g)}{ istruzione } 

if ( f unzione( ) ) { istruzione } 



Istruzione if... else 

A volte potreste desiderare che vengano eseguite una o più istruzioni se un'espres- 
•.II >ne è vera e un altro gruppo di istruzioni se l'espressione è falsa. A tal fine viene 
Utilizzata l'istnizione else in congiunzione con l'istruzione if . Ecco la sintassi per 
l'utilizzo dell'istruzione else: 

if ( condizione ) { istruzione } else { istruzione } 

< :i msiderate lo script seguente: 

<?php 

// Istruzioni if - Esempio 11-4 

B,;- ■ 

Snumber = 2; 

lf ($number%2) { 

echo "Il numero Snumber è dispari"; 

else { 

echo "Il numero Snumber è pari"; 

E . ■ 

?> 

l'esempio precedente visualizzerà "Il numero 2 è pari" poiché la variabile 
Snumber è un numero pari. Se il numero venisse modificato in 1, verrebbe visualiz- 
zalo "Il numero 1 è dispari". I.a condizione if funziona utilizzando l'operatore 
modulo, che in questo caso lesiiiuisce il resi o della divisione per 2 di Snumber. 



Istruzione elseif 



L'istruzione elseif è una combinazione di if ed else che opera in modo analogo 
all'istruzione else, in quanto consente l'esecuzione di un'istruzione quando 
l'espressione if è falsa. Tuttavia, a differenza di else, elseif eseguirà l'istruzione 
solo se l'espressione elseif è vera. Considerate lo script di esempio seguente: 



<?php 

// Istruzioni if - Esempio 11-5 

SnumbeM = 100; 
Snumber2 = 80; 



if (SnumbeM > $number2) { 

echo "$number1 è maggiore di $number2" ; 

elseif ($number1 == $number2) { 

echo "SnumbeM è uguale a $number2"; 

} 

else { 

echo "$number1 è minore di $number2"; 

?> 

Questo esempio verifica se il valore di $number1 è maggiore di $number2 e, se è 
\ i in >, visualizza un messaggio per segnalarlo, Se non è vero, i valori vengono con- 
l mniati per vedere se sono uguali; se è vero, invece, viene visualizzato il messaggio 
che segnala questa situazione. Infine, se le due condizioni precedenti sono false, 
viene visualizzato un messaggio che indica che $numberi è minore di $number2. 

Istruzioni complesse 

Le istruzioni if possono essere combinate per dar vita ad applicazioni molto com- 
plesse. È possibile utilizzare una qualunque combinazione di operatori logici o di 
confronto per controllare l'istruzione if. Potete utilizzare elseif (){. .} o el- 
se{ . .} per produrre istruzioni if più complesse, oppure ricorrere a istruzioni if 
annidate. L'esempio che segue illustra come verificare un nome utente e una 
password tramite istruzioni if : 

<?php 

//Istruzioni if - Esempio 11-6 

W^......, ......... , , ; ... , . , ;n ; .: ri , v'.y,, . . à 

$user = "admin" ; 
$pass = "12345" ; 

Susername = "admin" ; 
$password = "123456" ; 



//Verifica del nomo utente 



if($user == "") { 

echo "Nome utente non spocif ioatol " ; 

) 

olseif (Suser == "$username") { 

echo "Nome utente accettato"; 

) 

olse { 

echo "Nome utente non valido"; 

> 

tono "<br />" ; 
//Verifica della password 

tf($pass == "") { 

echo "Password non specificata!"; 

Il 

tl8eif($pass == "$password") { 

echo "Password accettata"; 

} ■Kf.-V--''- 

olse { 

echo "Password non valida"; 

?> 

L'esempio precedente utilizza due istruzioni if : una per verificare l'esattezza di un 
nome utente e l'altra per controllare che la password sia corretta, supponendo che 
Il nome utente memorizzato sia "admin" e la sua password sia "123456". 
Lo script inizia dichiarando le variabili $user e $pass, che rappresentano il nome 
utente e la password forniti dall'utente. Vengono inoltre dichiarate le variabili 
$use marne e $password, che contengono i valori con cui saranno confrontate 
Suser e $pass: 

$user = "admin" ; 
$pass = "12345"; 

Susername = "admin"; 
Spassword = "123456"; 

La parte successiva dello script controlla se è stato fornito un nome utente e, in tal 
. aso, verifica che il valore immesso sia uguale a quello memorizzato in $username: 

//Verifica del nome utente 
if ($user = "") { 

echo "Nome utente non specif icatol " ; 

} 

elseif (Suser == "Susername") { 

echo "Nome utente accettato"; 

else { 

echo "Nome utente non valido"; 

F) 

echo " <br />"; 



L'ultima parte dello script esegue le stesse operazioni di prima sulla password! 

/ / Verifica della password 
if ($pass == "") { 

echo "Password non specificata!"; 

elself ($pass == "Spassword") { 

echo "Password accettata"; 

} 

else { 

echo "Password non valida"; 



Un esempio di output prodotto dallo script precedente è illustrato nella Figura Ili. 



! 



http:/ /localhQSt/phpbook/esempio 1 1 -6.php - Microsoft Interne 



difica Visualizza ' Preferiti Strumenti ? 



^'indietro' v4.'.^l & 1 ^ Cerca a Preferiti" 



indirizzo http://localhost/phpbook/esempioli-6.php 




Nome utente non valido 
Password non valida 



Figura 11.1 

Un semplice script di login realizzato con istruzioni if. 



Istruzione switch 



L'istruzione switch è simile a una collezione di istruzioni if e viene utilizzata 
quando desiderate confrontare una variabile con diversi valori ed eseguire diverse 
istruzioni in relazione al suo valore. Potreste ottenere lo stesso risultato ricorrendo a 
istruzioni if ,. ma c'è il rischio che il codice diventi complesso e difficile da 
^ridere. La sintassi dell'istruzione switch è la seguente: 




(espressione) 



case costante_espressione : istruzione 
case costante_espressione : istruzione 



■ 



ì 



default : istruzione 



Lo script che segue utilizza un'istruzione switch per controllare 
Strare un saluto. 



re l'ora locale e mo- 



uni il e iwiiui oi 



L'ora corrente è riK-in» >n/./;ii.i nella variabile Stime. Se è 8 viene visualizzato il mes- 
saggio "È ora di al/.u si .«• «• lo, viene visualizzato il messaggio "È ora di 
fare merenda"; se invece e 23, viene visualizzato il messaggio "È ora di andare 
a letto". Qualunque altra ora produrrà la visualizzazione del testo "Non è ora 
di fare nulla". 



<?php 

// Istruzioni if - Esempio 11-7 



Stime = date ( "G" ) ; 

echo "Sono le ore $time<br />"; 

switch (Stime) { 

case 8 : echo "È ora di alzarsi<br />"'; 
break; 

case 16 : echo "È ora di fare merenda<br />"; 
break; 

case 23 ; echo "È ora di andare a letto<br />"; 
break; 

default: echo "Non è ora di fare nulla<br />"; 

} 

ttk: ■■ 

Le istruzioni break di questo esempio sono utilizzate per uscire dall'istruzione 
switch. Nel caso in cui fossero omesse, vengono eseguite tutte le istruzioni in tutti 
i case dopo il primo considerato vero, come illustrato di seguito. 

<?php 

// Istruzioni if - Esempio 11-8 

m- 

Stime = date ("G") ; 

echo "Sono le ore $time<br />"; 

switch (Stime) { 

case 11 : echo " Buongiorno Kbr />"; 

case 16 : echo "Buon pomeriggio !<br />"; 

case 23 : echo "Buonanotte !<br />"; 

I . ' ' 

?> 

In questo esempio, nel caso in cui siano le ore 11, l'output prodotto è visibile nella 
Figura 11.2. 




Figura 11.2 

Istruzioni switch senza parte break. 



Riepilogo 

Questo capitolo ha introdotto le istruzioni if e switch illustrando come possano 
essere impiegate per controllare quali istruzioni vengono eseguite. Si è visto inoltre 
come gli operatori logici e relazionali introdotti nel capitolo precedente possano es- 
sere utilizzati con queste istruzioni. Nel prossimo capitolo verranno presentate altre 
strutture di controllo, i cicli. 



Capitolo 12 

Cicli 



Introduzione 

Come in qualunque linguaggio di programmazione, i cicli costituiscono una pane 
essenziale e vengono utilizzati per consentire l'esecuzione ripetuta di un blocco di 
.(«lice. Esistono quattro tipi di cicli: for, while, do while e for each, ciascuno 
Bei quali prevede impieghi specifici. Tutti i tipi di ciclo sono controllati da espres- 
sili e condizioni. In questo capitolo verranno analizzati i primi tre tipi di ciclo, 
nu niie il costrutto for each verrà illustrato nel Capitolo 14, in quanto si tratta di un 
jtpo di ciclo utilizzato soltanto per accedere al contenuto di un array. Per comincia- 
li uà preso in esame il ciclo while. 

Ciclo while 

I ( irli while presentano una struttura poco complessa e sono molto comuni in 
l'I II'. Il significato di un'istruzione while è semplice: essa indica all'interprete PHP 
di eseguire ripetutamente le istmzioni annidate nel ciclo fino a quando l'espressio- 
ni' while viene valutata TRUE. Il formato del ciclo while è il seguente: 

while {espressione) {istruzione} 

A (.fini iterazione il valore dell'espressione viene verificato all'inizio del ciclo; se 
I espressione while viene valutata FALSE sin dall'inizio, le istruzioni annidate non 
■Manno eseguite nemmeno una volta. È possibile utilizzare le parentesi graffe per 
HCchiudere diverse istruzioni che devono essere eseguite nel ciclo. Lo script afe- 
I me illustra un semplice ciclo while: 

<7php 

// Cicli - Esempio 12-1 
// 

N - 1; 

while ($a<=10) 
{ 

echo "Questo è il miatro M'ftr»'; 



$a++; 

} 

?> 



In questo esempio la variabile $a è impostata a 1. L'espressione del ciclo verifica se 
a va ore di $a e minore o uguale a 10 e in tal caso il contenuto del ciclo viene ela- 
qUe t°, es ^ m P , ° i vien f i utilizzata un'istruzione echo per visualizzare il va- 
lore della variabile $a. Inoltre il valore della variabile $a viene incrementato di 1 a 
Ogni esecuz.one del contenuto del ciclo. Alla fine il valore di $a sarà pari a 11, quin- 
ci! lo scr.pt terminerà. L'output di questo script è illustrato nella Figura 12 1 
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Figura 12.1 

Un semplice ciclo while. 




I cicli while, nella maggior parte dei casi, vengono utilizzati con una variabile inte- 
ra che viene incrementata o decrementata a ogni iterazione del ciclo. L'espressione 
del ciclo viene verificata ogni volta per determinare se il ciclo dev'essere eseguito 
ancora una volta oppure se il controllo deve passare all'istruzione che segue il ciclo 
n questo caso la fine dello script). Se una variabile non viene né increLntata né 
decrementata nel celo, quest'ultimo non avrà termine, e lo stesso accadrà allo script 
i nr. per esempio: 



Esempio 12-2 




$a = 1; 

while ($a<=10) 



?> 



echo "Questo è il numero $a<br>"; 



gonaigliamo di non piovan Ire questo script nel browser, poiché il server 

Web potrebbe non rispondere più (,)ueMo script, tuttavia, mostra un'utile caratteri- 
Sina dei cicli che racchiudi mi i .il loro interno un'unica istruzione, ossia la possibilità 
di omettere la coppia di parentesi graffe di apertura e chiusura. 



Ciclo do while 

Il ciclo do while è simile al ciclo while; la differenza si nota nel momento in cui viene 
verificata la veridicità dell'espressione del ciclo. In un ciclo while l'espressione del ciclo 
Irtene verificata all'inizio; pertanto, se l'espressione è falsa, nessuna delle istnizioni del 
ciclo verrà eseguita. Nel caso di un ciclo do while, invece, l'espressione viene valutata 
alla fine del ciclo, dopo che le istruzioni sono state eseguite almeno una volta. Questo è 
il motivo per cui un ciclo do while è noto come ciclo iterativo "uno o molti", in quanto 
le istruzioni al suo interno vengono eseguite almeno una volta, e forse molte volte. Un 
ciclo while è noto, invece, come ciclo "zero, uno o molti" poiché le istruzioni potreb- 
bero non essere eseguite. Il formato del ciclo do while è il seguente: 

do {istruzione} while {espressione) ; 

Lo script seguente illustra un semplice ciclo do while: 

IH ! • 

<?php 

// Cicli - Esempio 12-3 
// 

$num = 0; 
do { 

echo "Questo è un ciclo do-while"; 
} while ($num > 0); 

?> 

L'esempio precedente illustra un ciclo che non visualizzerebbe alcunché se venisse 
implementato con il costrutto while, in quanto l'espressione viene valutata subito 
falsa. Dato invece che un ciclo do while elabora sempre il contenuto del ciclo al- 
meno una volta (poiché l'espressione viene verificata alla fine e non all'inizio del ci- 
clo), il messaggio "Questo è un ciclo do-while" viene visualizzato. 



Ciclo for 

Un altro tipo di ciclo molto diffuso è for, anche se a prima vista appare molto più 
complesso dei cicli while e do while, in quanto il costrutto incorpora tre espres- 
sioni. La prima espressione viene utilizzala per impostare un punto di inizio del ci- 
clo, la seconda i l'i pn i'nn che controlla quante volte verrà ripetuto il ciclo, 
mentre la terza e quella uiili//.na normalmente per incrementare la variabile utiliz- 
zata per controllali il numno ,|, u, i.i/iom II l'ormato del ciclo for è il seguente: 

for {espresslontl; »$pr§»t tonti; •ipr*»Hone3) {istruzione} 



fi possibile utilizzare Ir pattuir»» pulì. I" ' M< < Illudere diverse istruzioni da esegui- 



BB nel ciclo, proprio come avviene nei cicli while e do while. L'esempio che segue 
illustra un breve ciclo f or utilizzato per generare dieci numeri: 

<?php 

// Cicli • Esempio 12-4 

// 

for ($count=0; $count<=10; $count++) 
echo "Scount "; 

T» 

-l'H'Mi' esempio il valore iniziale di $count viene definito come 0 dalla prima 
l< ne, i he indica al ciclo di partire da 0. La seconda espressione è la condi- 
■•n ine • li terminazione del ciclo e verifica se Scount è minore o uguale a 10. Se è co- 
" 'I Ciclo continua. L'ultima espressione incrementa la variabile Scount di 1 a ogni 
mutoOÈ del ciclo. L'output di questo script è illustrato nella Figura 12 2 
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Figura 12.2 

Utilizzo di un ciclo for per generare dieci numeri. 



Spesso i cicli possono essere utilizzati per generare molto codice HTML, in partico- 
lare- tabelle. Nell'esempio che segue vedremo come un ciclo for possa dar vita a 
una tabella con sei righe e due colonne: 

<?ptip 

// Cicli - Esempio 12-5 

// 

?> 

<html> 
<body> 

<table width "40%" border="l*> 
<? 

for ($c=0;$c<6;$c++) 
echo "<tr>" ; 

echo "<td>Colonna 1 Riga Sc</td>"; 
echo "<td>Colonna 2 Riga $c</td>"; 
echo "</tr>"; 



?> 

</table> 

*/body> 

</html> 

I | utput eli questo script è illustrato nella Figura 12.3- 
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Figura 12.3 

Utilizzo di un ciclo for per creare una tabella con numeri di colonna e di riga. 

Cicli annidati 



Un ciclo annidato è un ciclo interno ad un altro. La prima iterazione del ciclo più 
. .in no comporta l'elaborazione per intero del ciclo interno; poi ha inizio la secori- 
m iterazione del ciclo esterno, che elabora nuovamente il ciclo interno, e così via. I 
Sdì annidati costituiscono uno strumento di programmazione molto potente, in 
grado di produrre output complessi con un numero ridotto di istruzioni. 
E possibile annidare una qualunque combinazione di cicli di diverso tipo. Il codice 
Che segue illustra un ciclo while annidato in un ciclo for. 

<?php 

// Cicli - Esempio 12-6 
// 

for ($y=4; $y<6; $y++) 
< 

echo "<br><b> Tabellina del $y </b><br>"; 



$x = 1 ; 

while ($x<13) 

Sresult - l.-ly, 

echo "$y » • •r»»ul» «br»'; 



} 

> 

?> 



i e» impio crea le tabelline del quattro e del cinque. Il ciclo f or esterno viene utiliz- 
ila i per creare ciascuna tabellina. mentre il ciclo while interno serve eseguire i cal- 
coli. L'output prodotto è illustrato nella Figura 12.4. 
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4x3-12 
4x4-16 
4 x 5 - 20 
4 x 6 - 24 
4 x 7 - 28 
4 x 8 - 32 

4 x 9 - 36 
4x 10-40 
4x 11-44 
4x12-48 

I .h-llm. del 5 

3x1-3 
3x2-10 
3x3-15 
5x4-20 

5 x 5 - 25 

5 x 6 - 30 
5x7-35 
5x8 = 40 
5x9 = 45 
5x10 = 50 
5x11 = 55 
5 x 12 = 60 



Figura 12.4 

Le tabelline create con i cicli annidati. 




Interruzione o continuazione 
forzata di un ciclo 

il .ornando break può anche essere utilizzato per porre termine all'esecuzione di 
un ciclo while, do while o f or; può inoltre accettare un argomento di tipo nume- 
£eo che indica da quanti cicli annidati è necessario uscire. Considerate l'esempio 

i . Mente: . 

«?php 

// Cicli - Esempio 12-7 
// 

$count = 0; 
while (1) 
< 

echo "Iterazione $count<br>"; 
if ($count == 10) { break;} 
else{ $count++; } 

?> 

Qui viene utilizzato un ciclo while che verrà iterato all'infinito, poiché l'espressione 
del ciclo while ( 1 ) è sempre vera. Viene utilizzato il comando break per termina- 
le il ciclo quando il valore di $count raggiunge 10. 

I Istruzione continue viene utilizzata in un ciclo per evitare l'elaborazione delle 

ii ni /.ioni rimanenti dell'iterazione corrente, passando all'iterazione successiva. 
( il >nsiderate l'esempio seguente: 

<?php 

// Cicli - Esempio 12-8 

ut 

for ($count=1; $count<20; $count++) 

if (Scount % 2) { continue; } 
echo "Scount è pari <br>"; 

> 

?> 

(.'in sto script viene iterato da 1 a 19 e visualizza solo i numeri dispari. Infatti, 
nel caso in cui il valore di $count sia pari, viene eseguita l'istruzione continue, 
i Ih non porta all'esecuzione dell'istruzione echo. L'output di questo script è il- 
lustrato nella Figura 12.5. 
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• i //. >,HIV.tn.izione continue. 



Riepilogo 

■piti ili > è stato introdotto il concetto di flusso di controllo attraverso i ci- 
\- 1 ii \ Imo che i cicli possono essere impiegati per ripetere molte volte una se- 
lci ci «lice e sono quindi utili al programmatore, in quanto riducono il lavoro 
li u* llfli i ne( i ssano. Avete visto come i cicli possano contenere un numero varia- 
iMruzioni PHP e possano persino includere altri cicli. Nel prossimo capitolo 
«lirti Ci ime potete iniziare a dividere e strutturare il codice attraverso funzioni e 

Ih In lini 



Capitolo 13 

Funzioni e file inclusi 



Introduzione 

Questo capitolo introduce il concetto di funzioni. PHP è dotato di una libreria che 
Contiene centinaia di funzioni già scritte e pronte all'uso. Le funzioni semplificano 
notevolmente il lavoro dei programmatori espandendo il nucleo fondamentale del 
linguaggio e mettendo a disposizione funzionalità avanzate. Tuttavia, per quanto 
I >< issa essere valida una libreria di funzioni, essa non conterrà mai tutte le funzioni 
i he occorrono. In questi casi dovrete crearne di vostre. Potreste anche voler divide- 
re il codice in file PHP separati e includerli insieme per dar vita a un unico grande 
script PHP. Questo capitolo spiega come fare. 

Che cos'è una funzione 

Le funzioni sono blocchi di codice che vengono elaborati solo quando la funzione 
k iene chiamata. Se la funzione non viene chiamata, il codice al suo interno non ver- 
rà mai eseguito. Una funzione può essere chiamata (a volte si dice anche "invoca- 
la") da un punto qualunque dello script. Una volta eseguita la funzione, il flusso di 
l < introito del programma ritorna al punto dello script immediatamente successivo 
alla chiamata. 



Funzioni definite dall'utente 

Le funzioni definite dall'utente sono blocchi di script che potreste voler chiamare 
pi ii volte. Le funzioni eliminano la necessità di duplicare il medesimo blocco di 
m ripi, in quanto una funzione può essere chiamata dall'interno di un semplice ci- 
clo. Ciò riduce le dimensioni dello script e rende più produttivo il programmatore. 
Le funzioni conferiscono Ulti maggiore leggibilità agli script e pertanto ne agevola- 
mi la manutenzione. 

Una funzione può i sm ic di liiul.i lon Li sintassi seguente: 



funtion nome (arg_l, *rfl_#, irg_ft) 



script 

return valore: 

} ( y: \ \ 

I t I unzioni hanno sempre un nome univoco (in modo da poter identificare quale 
I unzione utilizzare). Presentano anche codice racchiuso tra parentesi graffe che ta- 
lli ano l'inizio e la fine della funzione. Alcune funzioni hanno argomenti, ossia Va- 
riabili che vengono passate alla funzione e determinano ciò che la funzione farà. Al- 
imi- funzioni, inoltre, restituiscono un singolo valore variabile. 



Creazione e chiamata di una funzione 

L'esempio che segue illustra una semplice funzione che crea una tabella HTML. 
Non vengono definiti argomenti e non viene restituito alcun valore al termine 
dell'esecuzione della funzione, ma verrà creata una tabella. Questa è la struttura più 
semplice di funzione definita dall'utente e viene utilizzata raramente: 

<?php 

//Funzioni e file inclusi - Esempio 13-1 



function create_table( ) 
{ 

echo" <table border ' 1 ' bgcolor= ' #DBDBDB ' width='394' height='121> "; 
echo" <tr>"; 

echo" <td>cella 1</td> "; 
echo" <td>cel1a 2 </td> "; 
echo" </tr> "; 
echo" </table> "; 
echo"<br />"; 

ì 

II Chiama la funzione 
create_table() ; 

?> 

Lo script definisce una funzione denominata create_table. Il codice contenuto 
nella funzione è quello racchiuso tra le parentesi graffe {} ed è costituito da una se- 
rie di istruzioni echo: 

function create_table() 
{ 

echo" <table border '1' bgcolor= 1 #DBDBDB ' width='394' height= 1 121 '> ": 
echo" <tr>"; 

echo" <td>cella 1</td> "; 
echo" <td>cella 2 </td> "; 
echo" </tr> "; 
echo" </table> "; 
echo"<br />"; 



Per eseguire la funzione è necMNlt 1 1 Murarla, e ciò avviene con la riga seguente: 
create_table(); 

Mursia istruzione chiama la funzione senza passarle argomenti. L'output di questa 
(Unzione è illustrato nella Figura 13.1. 



3htlp://localhost/phpbook/esempiol3-l.php - Microbo 




,lpf*l 


Rie Modifica Visuali2aa Preferiti Strumenti ? 






^Indietro - •+ ■ $ _f\ |fl Cerca _*] Preferiti 


^Multimedia Igj* - % 


Uh 


Indrlzzo http://localhost/phpbook/esempiol3-l.php 


ij fv>Vai 


Collegamenti * 




cenai 




cella 2 

















^ Operazione 



Figura 13.1 

L'output di una semplice funzione. 



Creazione di una funzione con argomenti 

i ili argomenti sono utilizzati per controllare l'output e il comportamento della fun- 
zione. Nell'esempio precedente è stata creata una tabella HTML statica e nient'altro. 
m se voleste modificare la dimensione della tabella in base alle vostre necessità? 
Questo è possibile utilizzando argomenti per controllare la larghezza e l'altezza del- 
la tabella. Nell'esempio che segue l'argomento $w definirà la larghezza della tabella, 
mentre $h ne determinerà l'altezza. Gli argomenti sono separati da virgole (,) e non 
< i sono limiti alla quantità utilizzabile in una funzione. Nel caso in cui l'argomento 
sia uno solo, non sono necessarie virgole. Ecco uno script di esempio che utilizza 
una funzione con argomenti: 

<?php 



//Funzioni e file inclusi - Esempio 13-2 

// 



function create_tabl«($w, Ih) 



< 



echo" <table bordor 

echo" <tr>-; 

•cho" <td>cell« Wtd» '\ 

tcho" <td>collo 2 </ttì» ! 



i baco l or • 



' width-'SW height='Sh'> "; 



echo" </tr> •; 
echo" </table> "; 
echo"<br />" ; 

} 

//Chiama la funzione passando i valori 
create_table(500, 100) ; 

?> 

L'output di questo script è simile a quello dell'esempio precedente, con la differen- 
za che adesso la tabella è molto più larga. Provate a chiamare la funzione passando 
diversi valori come argomenti. 



Argomenti predefiniti 

A volte, utilizzando le funzioni in diverse parti di uno script, potreste volere che gli 
argomenti abbiano valori predefiniti da utilizzare nel caso in cui la funzione venga 
chiamata senza argomenti. Supponete, per esempio, di volere che nella maggior 
parte dei casi la funzione di creazione della tabella produca tabelle di larghezza e 
altezza di 100 x 100 pixel, ma anche di poter modificare questa impostazione se ne- 
cessario. Quanto appena descritto è possibile grazie agli argomenti predefiniti, che 
possono essere impostati con un dopo ciascun argomento nella definizione del- 
la funzione, per esempio $w=100. 

Osservate che alcuni o tutti gli argomenti possono avere valori predefiniti, che de- 
vono essere separati da virgole. Lo script seguente fornisce un esempio: 

Wit .. . 

<?php 

//Funzioni e file inclusi - Esempio 13-3 

// 

function create_table($w=100, $h=100) 

echo" <table border '1' bgcolor= ' #DBDBDB ' width='$w' heiqht='$h'> "• 

echo" <tr>"; ' 

echo" <td>cella 1</td> "; 

echo" <td>cel1a 2 </td> '; 

echo" </tr> "; 

echo" </table> "; 

echo"<br />"; 

} 

//Chiama la funzione senza valori 
create_table() ; 

//Chiama la funzione passando i valori 
create_table(300,100) ; 

?> 

In questo esempio viene utilizzata la stessa funzione create_table( ), ma gli argo- 
menti $w e $h hanno ciascuno il valore predefinito 100: 

function create_tablt($w-lM, $h=l0O) 



Ora è possibile chiamare la funzione Ben» argomenti: 
create_table(); 

Potete però sovrascrivere gli argomenti predefiniti impostando un nuovo valore 
m ila chiamata a funzione: 

create_table(300,l00) ; 

L'output di questo script è illustrato nella Figura 13-2. 
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Argomenti predefiniti. 
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Restituzione di valori 

L'esecuzione del codice interno alle funzioni si interrompe quando esse incontrano 
la parola chiave return-. 

<?php 

//Funzioni e file inclusi - Esempio 13-4 

Ai «.»......•-- - -------- 

function testo 
{ 

echo "Questa è una provt"; 
return; 



^echo "Questa è un'altra prova"; 

testo ; 
1> 

In questo esempio l'output prodotto è "Questa è una prova", poiché l'istruzione 
return viene prima di raggiungere la seconda istruzione echo. 
Questa parola chiave non sarebbe molto utile se venisse utilizzata solo in questo 
modo, quindi ecco un altro possibile impiego. Il comando return può essere utiliz- 
zato per restituire un valore. In PHP è possibile definire funzioni che restituiscono 
un singolo valore: 

<?php 

//Funzioni e file inclusi - Esempio 13-5 

// 



function addition($first, Ssecond) 
{ 

$sum = $first + $second; 

return $sum; 

} 

//Chiama la funzione 
Scheck = addition(2,5) ; 

echo Scheck; 

?> 

Nell'esempio precedente abbiamo una semplice funzione che utilizza due argomenti. 
La funzione si limita a sommare i valori di due variabili e restituisce il risultato: 

function addition($first, Ssecond) 
{ 

Ssum = Sfirst + Ssecond; 
return Ssum; 

} 

l tato che questa funzione restituisce un valore, è necessario "catturarlo", altrimenti 
nulra perduto; a tal fine lo si può memorizzare in una variabile, che è stata chiama- 
la Scheck: 

Scheck = addition(2,5) ; 

Tutto ciò che la funzione restituisce viene memorizzato nella variabile Scheck. Ri- 
correndo a un'istruzione echo è possibile, inoltre, osservare ciò che è stato restituito 
dalla funzione, in questo caso il valore 7. Lo script che segue mostra un esempio di 
valore restituito molto più utile: 

<?php 

//Funzioni e file inclusi • Esempio 13-6 

// 



function checktotal($a, Sb, $c) 
{ 

Ssum = $a + Sb + Se; 
return Ssum; 

) 

//Chiama la funzione 

Stotal = checktotaK.10,52,26) ; 

$total_vat = Stotal * 1.2; 

echo "Totale senza IVA: <b>$total</b>" ; 
echo "<br>"; 

echo "Totale con IVA 20%: <b>$total_vat</b>" ; 
?> 

La funzione precedente riceve tre valori che vengono sommati, quindi viene resti- 
tuito il totale. Supponete di avere un sito di e-commerce e di voler verificare il prez- 
zo totale di tre prodotti, che costano rispettivamente 10, 52 e 26, e che vogliate vi- 
sualizzare il costo totale e il totale IVA inclusa. La funzione checktotal() viene 
utilizzata per sommare i tre prezzi e restituire il risultato nella variabile Stotal. 
Supponendo che l'IVA sia il 20%, moltiplicate il valore restituito (in Stotal) per 1,2 
per ottenere il prezzo effettivo con IVA: 

Stotal = checktotal(10,52,26) ; 
$total_vat = Stotal * 1 .2; 

Infine utilizzate due istruzioni echo per visualizzare il prezzo totale con e senza 
IVA; l'output dello script è visibile nella Figura 13.3. 
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Utilizzo dei valori restituiti. 



Restituzione di più valori 

In precedenza abbiami > ai ci muti 1 fatto che in PHP le funzioni non possono re- 
stituire piu di un valori' l'i i la pn i imi mr si dovrebbe dire che possono solo resti- 
tuire un tipo singolo IVi .!*«"•'•«' il problema della resi ini /.ione di un singolo valore 
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è possibile utilizzare gli array. Nel prossimo capitolo vedrete come definire e utiliz- 
ili array, ma per ora ecco un semplice esempio di funzione che restituisce un 
array, Non preoccupatevi se non comprendete la sintassi degli array; verrà spiegata 
tra breve: 

<?php 

//Funzioni e file inclusi - Esempio 13-7 
// 

function three_names( ) 
{ 

Snames = array ( "Simon" , "Mike", "Liz"); 
return Snames; 

} 

//Chiama la funzione 
SmyNames = three_names( ) ; 

echo "Primo nome: " . $myNames[0) ; 
echo "<br />Secondo nome: " . SmyNames[1]; 
echo "<br />Terzo nome: " . SmyNames [2] ; 



Argomenti passati per valore 

Quando si passa un argomento a una funzione, il suo valore viene automaticamen- 
tC [ tassato per valore"; ciò significa che viene passata solo una copia della variabi- 
le. Quindi se quel valore viene modificato nella funzione, il valore della variabile 
esterna alla funzione rimane invariato. Considerate l'esempio seguente: 

<?php 

//Funzioni e file inclusi - Esempio 13-8 

// ' ,,g W i r f ^ 1 v ' : '* v '' ' ' 

Snumber = 2; 

function simple (Snumber) 
{ 

Snumber = Snumber + 2; 

} 

simple(Snumber); 
echo Snumber; 

?> 

Questo esempio dichiara una variabile Snumber e le assegna il valore 2. Il valore 
viene passato alla funzione simple ( ) e viene poi cambiato in 4. Dopo la chiamata 
alla funzione, viene visualizzato il valore di Snumber, che è 2. In un certo senso si 
potrebbe dire che la funzione non ha avuto alcun effetto sul valori' della \ ambile. 
Il motivo per cui la variabile sembra tornare al valore originale è che alla I un /ione è 
Stata passata una cnpu Il.i amabile, ed è questa copia che unir hli. .u.i non 



l'originale. Quando la rUMtOTM ha .omplelato la propria esecuzione, la variabile 
originale all'esterni . della Inii/ioix esiste ancora ed è immutata. 



Argomenti passati per riferimento 

Potreste voler passare una variabile a una funzione "per riferimento". L'utilizzo delle 
variabili per riferimento è stato introdotto nel Capitolo 6. Per passare una variabile 
per riferimento a una funzione è sufficiente anteporre il carattere "&" al nome della 
variabile. L'utilizzo delle variabili per riferimento consente alla funzione di modifi- 
care il valore originale della variabile. Considerate l'esempio seguente: 

<?php 

//Funzioni e file inclusi - Esempio 13-9 
(// 

Svariable = 2; 

function simple (SSvariable) 
{ 

Svariable = Svariable + 2; 

> 

simple(Svariable) ; 
echo Svariable; 

?> 

Questo script dichiara una variabile Snumber, alla quiale viene assegnato il valore 2. 
tale valore viene passato per riferimento alla funzione simple (), che lo modifica 
in 4. Dopo la chiamata alla funzione viene visualizzato il valore di Snumber, che 
come ci aspettavamo è 4. 

Il passaggio delle variabili per riferimento è considerato una pratica pericolosa da 
molti programmatori (anche professionisti), in quanto estende l'ambito della varia- 
bile, aumentando di molto la probabilità di modificarne per errore il valore. Si con- 
siglia dunque di essere prudenti, quando si passano le variabili per riferimento. 

Funzioni all'interno di funzioni 

Le funzioni possono chiamare altre funzioni presenti al loro interno. Considerate 
l'esempio seguente: 

<?php 

//Funzioni e file inclusi - Esempio 13-10 

I$h- 

function decimai ($num| 
( 

$num » round (fnum, 2); 
return $num; 

I 
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function multiply(&$number) 
i 

Snumber = Snumber * 3.14; 
echo Snumber . "<br />"; 
Snumber = decimal(Snumber) ; 
echo = Snumber; 

» 

Snumber = 5.2234; 
nultiply(Snumber); 



In questo script viene definito un valore in virgola mobile che viene passato alla 
Imi/ione multiply ( ) : 

Svalue = 5.2234; 
multiply($number}; 

J 

La funzione moltiplica il numero per 3,14 e quindi visualizza il suo valore corrente: 

Snumber = Snumber * 3.14; 
echo Snumber . "<br />; 

Poi chiama la funzione decimalo passandole il valore di Snumber e supponendo 
che il valore verrà restituito e infine visualizzato: 

Snumber = decimal($number} ; 
echo = Snumber; 

La funzione decimalo riceve la variabile e con la funzione predefinita round (), 
arrotonda il valore alla seconda cifra decimale e restituisce il risultato: 

function decimai (Snum) 
{ 

Snum = round($num, 2}; 
return Snum; 

} 

L'output prodotto da questo script è il seguente: 

16.401476 
16.4 



Funzioni ricorsive 

Una funzione ricorsiva è una funzione che chiama se stessa. Si tratta di una situazio- 
ne complessa, ma utile nella valutazione di alcuni tipi di funzioni matematiche. Po- 
treste trovare costrutti di questo tipo in alcune strutture dinamiche di gestione dei da- 
ti, come liste collegate o alberi binari. 




Il codice che segui- pics. ni i un . .. m|>i<> di uiili//odi una l'unzione ricorsiva per de- 
terminare se un numero è un i |« <i n/.i di 2. 



<?php 

//Funzioni e file inclini • EMfliplo 13-11 

// 

function is_power_of_two($n) 
I 

if ($n == 1) 

VP 

echo "sì"; 

1 } 

elseif ($n%2 == 1) 

i- * 

return "no"; 

} 

else 
i 

$n /= 2; 

return is_power_of_two($n) ; 

} 

} 

echo is_power_of_two(256) ; 
?> 

In questo esempio il numero 256 viene controllato per vedere se è o meno una po- 
tenza di 2 passandolo alla funzione is_power_of_two(): 

echo is_power_of_two(256) ; 

Quando la funzione viene chiamata, un'istruzione if verifica se il numero è uguale 
a 1 e, in tal caso, viene visualizzato il valore "sì"; in caso contrario viene utilizzata 
un'altra istruzione if , per verificare se la divisione per 2 del valore corrente $n è 
uguale a 1. Se è vero, viene visualizzato il valore "no": 

if {$n == 1) 

i 1* 

echo "sì"; 

} 

elseif ($n%2 == 1) 

[ < 

return "no"; 

v il numero non soddisfa nessuna di queste due istruzioni viene diviso per 2, e la 
mozione chiama se stessa < i in l'istruzione return funzione(): 

else 



{ 

$n /= 2; 
return is_power_of 
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include, include once 

l un m si è visto come creare funzioni che svolgono operazioni specifiche. Le fun- 
zioni i ( «sentono di dividere il codice in porzioni gestibili. Un altro modo per sud- 
. Ii\ idere il indit e consiste nel separare uno script PHP di grandi dimensioni in di- 
m i i ti più piccoli. Questa tecnica consente di condividere e riutilizzare in 
modo pni .ik< vi'I<' gli script. Considerate lo script seguente: 

«7php 

//Furuloni • file inclusi - Esempio 13-12 
// 

•fifttMM - 'Simon-; 
laurnaaa - -8tobarf; 



l ili in un. i ih in ni e molto interessante, poiché si limita a definire due variabili; tut- 
II illi in. ludere questo file in un altro script tramite l'istruzione include: 

includa (nomatile); 

• '> i l'MMIiplo: 

•7php 

ni e file inclusi - Esempio 13-13 

// 

•cho $flrstname; 

includa ( "esempio13-12.php" ) ; 

echo "<br />" . Ssurname; 

7> 

Lo script precedente utilizza l'istruzione include per "copiare" lo script del file 
esempio 13-12. php nel punto dello script in cui compare l'istruzione include. 
Questo produce la visualizzazione del messaggio seguente: 

Notice: Undefined variable: firstname in 
c:\inetpub\wwwroot\phpbook\esempio13-13.php on line 6 

Stobart 

Questo avviso viene generato poiché il valore della variabile $f irstname non è 
noto quando si raggiunge la prima istruzione echo. Sarebbe sufficiente spostare 
l'istruzione include prima della prima istruzione echo per eliminare il messaggio. 
Nel caso in cui sia impossibile trovare il file incluso, viene generato un avviso, ma 
IVlaborazione dello script continua. L'istruzione include_once( ) opera allo stesso 
modo di include ( ) , con l'unica differenza che lo script contenuto in un file viene 
incluso una sola volta nell'esecuzione dello script. Il formato dell'istruzione è il se- 
guente: 



Include_once (nomatile); 



runzioni e ine inausi iut 



require, requireonce 

Queste istruzioni funzionano esattamente allo stesso modo di include e 
include_once; l'unica differenza è nella modalità di gestione degli errori. Nel caso 
sia impossibile individuare un file, viene generato un errore irreversibile e l'esecu- 
zione dello script termina. 

Riepilogo 

Questo capitolo ha introdotto le funzioni, mostrando come vengono create e come 
i.i possibile passare a esse variabili sia per valore sia per riferimento. Si è visto inol- 
tre che è possibile includere script PHP separati in uno script da eseguire. Il Capito- 
li > 1 4 prende in esame la struttura di dati nota come array. 



Capitolo 14 

Array 



Introduzione 

:sto capitolo verrà introdotto il concetto di array. Gli array sono essenziali per 
ripolazione di insiemi di variabili correlate. PHP supporta sia gli array a una 
dimensione sia quelli multidimensionali. Gli array possono essere utilizzati per rac- 
cogliere dati, come nomi di persone, ed eseguire operazioni su questi dati nel 
modo più semplice possibile. Inizieremo illustrando cosa si intende con array a una 
dimensione e come crearne uno. 



Array a una dimensione 

rli array a una dimensione sono contenitori in grado di memorizzare una singola se- 
:nza di elementi indicizzati. Gli array sono simili alle variabili, ma. mentre queste 
me possono memorizzare un solo valore, gli array possono contenerne diversi. La 
jura 14.1 illustra un array a una dimensione contenente un elenco di ortaggi. 
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Figura 14.1 

Array a una dimensiono. 



L'array è caratterizzato da un nome, $veg, e da diversi elementi, < Lisi i dei quali 

contiene un valore, che in questo caso è un ortaggio. Ogni elemento ha un indice, 
che di default viene creato automaticamente a partire dal numero 0 e incrementato 
di 1 per ciascun elemento dell'array. 

Costrutto array 

\ 

In PHP la creazione degli array avviene con il costrutto array, che ha la forma se- 
guente: 

array = array ( [mixed. . . ] ) 

Per creare l'array illustrato nella Figura 14.1 è possibile dichiararlo nel modo se- 
guente: 

$veg = array( "pomodoro" , "piselli", "peperone" , "funghi", "peperoncino"; 

Questa istruzione crea un array chiamato $veg contenente cinque elementi che me- 
morizzano ortaggi. Il riferimento agli elementi dell'array può avvenire aggiungendo 
un indice al nome dell'array. Dato che in base alle regole predefinite la numerazio- 
ne degli indici di questo array va da 0 a 4, l'accesso al primo elemento dell'array 
può avvenire con l'istruzione seguente: 

echo($veg[0]); 

mentre questa istruzione riguarda l'ultimo elemento: 
echo($veg[4]); 

; I ' i&ttà&fuiilVi i- - ,>.'••'■ •j,'Kjkpx>ryi!j ti'iì .'. .'>.'!"'- •' 

Lo script che segue dichiara l'array degli ortaggi e visualizza il contenuto dell'array 

con il ricorso a un ciclo f or: 
<?php 

// Array - Esempio 14-1 

// ' 

$veg = array( "pomodoro" , "piselli", "peperone" , "funghi", "peperoncino"); 

for($a=0;$a<5;$a++) 

echo ($veg[$a] . "<br>"); 

\i> P: • ■ , ., 1 ",!'.■'■';",■ 

L'output di questo script è illustrato nella Figura 14.2. Benché la Figura 14.2 mostri 
che è possibile accedere al contenuto dell'array, non ha un aspetto particolar- 
mente accattivante. Cerchiamo quindi di rendere un po' più interessante l'output. 
Nello script che segue l'output è stato modificato in modo da generare una sem- 
plice tabella: 

. 

<table border='l'><tr> 



<?php 

// Array - Esempio 14-2 • 



$veg = array ("pomodoro" , "piselli", "peperone" , "funghi", "peperoncino"); 
for($a=0;$a<5;$a++) 

echo("<td><img src='graphics/" . $veg[$a] . " . jpg'></td>" ) ; 
echo("</tr>"); 
?> 

</table> 
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Figura 14.2 

Visualizzazione di un array. 



Lo script precedente visualizza una tabella le cui celle contengono i valori 
dell'array. Tuttavia, per rendere più interessante il risultato, sono state create 
semplici immagini che vengono utilizzate per rappresentare gli ortaggi contenu- 
ti nell'array; queste immagini sono state create e salvate con lo stesso nome con 
cui gli ortaggi sono memorizzati nell'array, con l'aggiunta dell'estensione .jpg. 
Le immagini e i loro nomi di file sono elencati nella Tabella 14.1. Queste imma- 
gini sono state salvate in una sottodirectory denominata "graphics" e collocata al 
di sotto della directory root. 

La Figura 14.3 illustra l'output prodotto dallo script precedente. 




ne di un indice numerico 



Nell'esempio precedente è stato creato un array dotato di indici automatici. È 
però possibile specificare manualmente l'indice dell'array. Considerate questo 
esempio: 

$veg = array(0=>"pomodoro\ 1->"piselli" , 2=>"peperone" , 3=>"funghi" 
4=>" peperoncino" ) ; 



dove la specificazione di un Indice può avvenire tramite l'operatore "=>". 
Nell'esempio precedente l'Imi pccllli ato esattamente come quello prede 



I LVJIU 1 T 
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Figura 14.3 

Una versione più interessante dell'output dell'array. 



finito, ossia un indice numerico che parte da 0 e viene incrementato di 1 ogni volta. 
Ma cosa accadrebbe se mettessimo gli elementi in ordine diverso o se dimenticassi- 
mo persino un numero di indice? Osservate, per esempio, la tabella che segue. 



Tabella 1 4. 1 Immagini degli ortaggi 



Immagine 



Nome del file 




pomodoro.jpg 



peperone.jpg 



piselli.jpg 



funghi.jpg 



Nell'esempio precedente l'indi. «' non viene fornito in ordine numerico. Per illustra- 
re cosa accade in questo caso, l'array è stato incluso nello script seguente: 



<table border=' 1 '><tr> 
<?php 

//Array - Esempio 14.-3 

I" ----- 

$veg = array (0=>" pomodoro" , 2=>"piselli" , 1 =>" peperone" , 3=>"", 

4=>"f unghi", 5=>"peperoncino" ) ; 

for($a=0;$a<6;$a++) 

if($veg[$a] == "") 

echo("<td><img src=' graphics / question. jpg 1 ></td>" ) ; 
else 

echo("<td><img src=' graphics/" . $veg[$a] . 
".jpg'x/td>-); 

H. . , , 

echo( "</tr>" ) ; 
</table> 

L'output di questo script è illustrato nella Figura 14,4. 

La Figura 14.4 mostra che, benché gli elementi dell'indice siano stati specificati in 
ordine non numerico, ciò non ha comportato alcuna differenza. I piselli sono stati 
collocati all'indice 2 e il peperone all'indice 1, ed è così che appaiono. Nel caso 
dell'elemento di indice 3, che è stato specificato come vuoto, non c'è alcun ortaggio 
da inserire nell'output, pertanto viene visualizzata l'immagine question.jpg. Questo 
avviene con l'aggiunta allo script di un'istruzione che controlla se l'indice è vuoto: 

if ($veg[$a] == "") 

echo( "<td><img sre 'graphics/question. jpg'x td>"); 




Figura 14.4 

Specificazione dell'output con un proprio indica. 



Ciclo foreach 



PHP include un costrutto di ciclo progettato in modo specifico per l'iterazione attra- 
verso gli array. Si tratta del ciclo foreach, che presenta due forme sintattiche. La 
prima è la seguente: 

foreach (Sarray as Svalore) istruzione 



In questo caso il ciclo viene iterato attraverso l'array fornito da $array. Il valore 
dell'indice corrente viene assegnato a $valore. L'indice dell'array viene poi incre- 
mentato di uno in modo che la successiva iterazione del ciclo accederà all'elemento 
successivo. Lo script seguente presenta una riscrittura dell'esempio precedente al 
fine di includere questo ciclo: 



<table border='1 '><tr> 
<?php 

// Array - Esempio 14-4 

$veg = array (0=>" pomodoro", 2=>" piselli" , 1=>"peperone" , 

4=>"funghi" , 5=>" peperoncino" ) ; 
foreach ($veg as $vegltem) 

echo("<td><img src='graphics/$vegltem. jpg ' ></td>" ) ; 
echo("</tr>"); 

., ,, ;: :kI ,-u ìi.. • • ! • ■ ■ '. wt%\ ' : •- S j . 'tl> ?v^i \iimiih 

</table> 

Questo script è meno complesso rispetto all'esempio precedente. Osservate inoltre 
che non è più necessario controllare se ci sono posizioni vuote, in quanto il ciclo 
foreach si porta automaticamente al successivo elemento indicizzato, come illustra 
l'output della Figura 14.5- 
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Figura 14.5 

Output del ciclo foreach, 



Osservate poi che l'output degli ortaggi avviene nell'ordine in cui vengono dichia- 
rati, non in base all'indice numerico, come accade con il ciclo f or. 
La seconda forma del ciclo foreach è la seguente: 

foreach ($array as Schiave => $valore) istruzione 

Questa istruzione foreach in pratica funziona come l'esempio precedente, ma in 
più assegna il valore dell'indice dell'elemento corrente alla variabile $chiave, come 
mostrato nello script seguente: 

II' " ' ! '■>:. ''" ' ■ ' «5 ' " • 

<table border='1 '><tr> 



<?php 

//Array - Esempio 14-5 
// ---- 



$veg = array(0=>"pomodoro" , 2=>"piselli" , 1 =>" peperone" , 4=> " funghi " , 

5=>" peperoncino" ) ; 
foreach($veg as Svegltem) 

echo("<td><img src='graphics/$vegltem. jpg'x/td>") ; 
echo("</tr><tr>"); 
foreach{$veg as $key=>$vegltem) 

echo("<td align= 1 center' >$key</td>") ; 

</trx/table> 

Questo script utilizza due cicli foreach: il primo produce le immagini che rappre- 
ndano gli ortaggi contenuti nell'array $veg; il secondo invece accede alla chiave 
ll'indice di ciascun elemento dell'array e visualizza il valore relativo in una secon- 
da riga della tabella sotto le immagini degli ortaggi. L'output di questo script è illu- 
strato nella Figura 14.6. 
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Figura 14.6 

Output degli indici con foreach. 
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Ma per quale motivo si d< ivivl il >o accedere ai valori di indice? Si è già visto come calco- 
larli utilizzando gli esempi di ciclo f oreach presentati in precedenza in questo capito- 
lo. Il l'atto è che i valori di indice non devono necessariamente essere numerici: si ve- 
drà che cosa significhi tutto ciò nella pratica, specificando alcuni indici non numerici. 



Specificazione di un indice non numerico 

Invece di specificare un array con indice numerico, è possibile specificarlo con un 
indice stringa. Per esempio: 

Sveg = array ( " Pomodoro "=>" pomodoro" , "Piselli"=>"piselli" , 
Peperone"=>"peperone" , " Funghi "=>"f unghi" 
"Peperoncino"=>"peperoncino" ) ; 

L'istruzione precedente dichiara ancora una volta un array costituito da ortaggi; tut- 
tavia, invece di utilizzare un indice numerico, specifica un indice sotto forma di 
stringhe che rappresentano i valori memorizzati negli elementi dell'array. Lo script 
seguente illustra l'uso di questa tipo di array: 

<table border- 'l'><tr> 

<?php 

// Array - Esempio 14-6 

$veg = array ( "Pomodoro"=>"pomodoro" , °Piselli"=>"piselli" , 

"Peperone"=>"peperone" , " Funghi "=>"f unghi" , 

" Peperoncino "=>" peperoncino" ) ; 
foreach($veg as Svegltem) 

echo( "<td><img src= ' graphics /$vegltem. jpg'x/td>" ) ; 
echo("</tr><tr>"); 
f oreach ($veg as $key=>$vegltem) 

echo("<td align='center'>$key</td>"); 

?> 

</tr></table> 

L'output prodotto dallo script precedente è quello della Figura 14.7. Osservate che 
ora vengono visualizzati sia i nomi degli ortaggi, ottenuti dagli indici, sia le immagi- 
ni che li rappresentano. 

Utilizzo degli array a una dimensione 

Ora sapete abbastanza degli array a una dimensione per cominciare a impiegarli in 
modo utile. Considerate lo script seguente: 

<table border=T><tr> 

<?php 

// Array • Esomplo 14-7 



Array 119 
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Figura 14.7 

Output dell'array con indici stringa. 

■ 

= array ( " pomodoro "=>23, "piseHi"=>78 J "peperone"=>34, "f unghi"=>56, 
" peperoncino "=>97); 

$cost=0; 

f oreach ($veg as $key=>$vegCost) 

echo ( " <td><img src= 1 graphics/$key . j pg 1 ></td>" ) ; 
echo("</tr><tr>"); 
f oreach ($veg as $vegCost) 
{ 

echo("<td align=' center '>$vegCost cent</td>"); 
$cost=$cost+$vegCost ; 

ocho("</tr>"); 
Scost=$cost/100; 

ocho("<tr><td align= 'center' colspan='5 ' >I1 costo totale degli ortaggi è 

$cost euro</td></tr>") ; 
ocho("<tr><td colspan='5' align=' center' ><img src='graphics/piselli. jpg ' > 

+ <img src='graphics/funghi. jpg'>") ; 
echo(" è pari a 11 . ($veg[ 'piselli' ) + $veg[ 'funghi' ] )/100 . " euro."): 

K ■ 
</tr></table> 

Viene creato un array i cui indici sono costituiti da stringhe. I valori sono i nómi del- 
le immagini, e consentono di accedere a esse. Gli elementi dell'array contengono 
valori interi che rappresentano il costo degli ortaggi: 

<table border='1 '><tr> 

<?php 

Sveg = array (" pomodoro "«>23, "pl8elli H ->78, "peperone"=>34, "funghi"=>56 
"peperoncino"»>97) ; 

Vengono utilizzati due i li II foroaoh ptn llUlUzZftre le immagini degli ortaggi e i 
loro costi. 



Osservate che la variabile $cost viene utilizzata per memorizzale il costo totale di 
tutti gli ortaggi: 



$cost=0; 

foreach($veg as $key=>$vegCost) 

echo ( "<td><img src= 1 graphics/$key . j pg 1 ></td> 11 ) ; 
echo("</tr><tr>") ; 
foreach($veg as SvegCost) 

{ 

echo("<td align=" center 1 >$vegCost cent</td>"); 
$cost=$cost+$vegCost ; 

} 

echo("</tr>"); 



$cost=$cost/100; 

echo( "<tr><td align= 1 center 1 colspan='5'>Il costo totale degli ortaggi è 
Scost euro</td></tr>" ) ; 

La parte finale dello script illustra quale sia la forza degli array dotati di indici strin- 
ga. In questo esempio viene sommato e visualizzato il valore di piselli e funghi. II 
codice risulta molto più leggibile poiché vengono utilizzati i valori "piselli" e "fun- 
ghi" invece che valori numerici. 

echo("<tr><td colspan='5' align=' center' ><img src='graphics/piselli. j pg " > 

+ <img src= 1 graphics/funghi. j pg ' > " ) ; 
echo(" è pari a " . ($veg[ 1 piselli ' ] + $veg[ 'funghi' ]) /100 . " euro."); 
?> 

</tr></table> 

La Figura 14.8 illustra l'output prodotto dallo script precedente. 
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Figura 14.8 

Utilizzo degli array. 




Array multidimensionali 

PHP supporta anche gli array multidimensionali, oltre a quelli a una dimensione. 
( IH array multidimensionali, in realtà, non sono altro che array di array a una dimen- 
sioni'. Invece di memorizzare una singola riga di elementi, gli array multidimensio- 
ngll possono memorizzare più righe di elementi. La Figura 14.9 illustra un an"ay 
miiliiclimensionale. L'array è costituito da righe che memorizzano nome, dimensio- 
ni- e numero delle forme. 



Creazione di un array multidimensionale 

l .i creazione degli array multidimensionali avviene con il costrutto array, Per crea- 
li- l'array illustrato nella Figura 14.9 si utilizza la sintassi seguente: 

' -^^a ■■ vii'**-'- 

Sshapes = array ( 

array( "stella" , "sole", "ruota", "fiore", "macchia"), 

array(50, 100,25, 125,150) , 

array(8,4,14,3,2) 



Il costrutto è costituito dall'array $shapes che contiene tre array a una dimensione 
Senza nome, ciascuno dei quali contiene separatamente il nome, la dimensione e la 
quantità di forme. 
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Figura I4.9 

Array multidimensionale. 
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I/accesso ;ii diversi array può avvenire con un valore di Indice, come avviene con 
gli array a una dimensione; poiché questo array ha due dimensioni, e necessario 
Utilizzare due indici. Per esempio; 

$var = $shapes[0] [2] ; 

Questa istruzione accede all'elemento 2 dell'array 0 (il primo array), che in questo 
esempio è "ruota". Lo script che segue illustra l'accesso ai dati contenuti nell'array 
attraverso un ciclo f or: 



<table border='1 '> 

<tr><th width=150>Forma</th><th Y/idth=100>Dimensione</th><th 
width=100>Quantità</th></tr> 

<?php 

//Array - Esempio 14-8 

// 



Sshapes = array( 

array ( "stella", "sole", "ruota" ."fiore" , "macchia") , 

array (50, 100,25, 125, 150) , 

array(8,4,14,3,2) 

); 

for($a=0;Sa<5;Sa++) 

Sname=Sshapes[0] [$a] ; 
Ssize=Sshapes[ 1 ] [Sa] ; 
Squantity=$shapes[2] [$a] ; 

echo( "<tr><td>$name</td><td>$size</td> <td>$quantity</td></tr>" ) ; 

?> 

</table> 



]| hi l \r.> /localhosfc/phpbook/esempiol4-8.php - Microsoft Internet 



l'ile Modifica Visualizza Preferiti ammanti ? 




Figura 14.10 

Output dell'array multidimensionale. 



Il programma precedente unii//;, un Mugolo cielo for per accedere al contenuto 
dell'array. Osservale che, dal.., he l'array Sshapes è costituito da altri tre array, sono 
stati utilizzati gli indici [0] , [ 1 ] tì [ 2] per accedere a tutti gli elementi di ciascuno dei 
ire array. L'output prodotto dallo script precedente è illustrato nella Figura 14.10. 

Utilizzo di foreach 

con un array multidimensionale 

Come per gli array a una dimensione, è possibile utilizzare il ciclo foreach per ac- 
cedere al contenuto dell'array. Rivediamo lo script dell'esempio precedente per 
produrre un output interessante. Lo script che segue utilizza lo stesso array di pri- 
ma, ma l'accesso ai dati avviene con un ciclo foreach: 

<table border='1 '> 
<tr> 

<?php 

//Array - Esempio 14-9 

11-" 

Sshapes = array( 

array ( "stella" , "sole" , "ruota" , "fiore" , "macchia" ) , 

array(50,100,25,125,150), 

array(8, 4, 14,3,2) 

m ... 

foreach (Sshapes [0] as $key=>$shape) 

r 

$size=$shapes[1 1 [Skey] ; 
$quantity=$shapes[2] [$key] ; 
echo("<td valign='top'>") ; 
for($count=0;$count<$quantity;Scount++) 

echo("<img src='graphics/$shape. jpg ' width='$size' 
height='$size'><br>") ; 
echo("</td>") ; 

n 

</tr></table> 

Oltre al ciclo foreach, i dati estratti dall'array vengono utilizzati per alterare l'out- 
put prodotto dallo script. Per ciascuna forma dell'array viene visualizzata un'imma- 
gine corrispondente. Le dimensioni (larghezza e altezza) dell'immagine sono con- 
trollate dai dati del secondo elemento array, mentre il numero di immagini visualiz- 
zate dipende dai chili del terzo array. Per esempio, la stella viene visualizzata come 
immagine da 50 X So pixel e ne vengono visualizzate otto. L'immagine della ruota 
invece ha dimensioni 25 x pixel e ne vengono visualizzate 14. L'output prodotto 
dallo script precedenti i HUiMriUo nella Figura 14.11. 
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Figura 14.11 

Output dell'array multidimensionale. 



Utilizzo di un indice non numerico 
con un array multidimensionale 

Nei nostri esempi precedenti di array multidimensionali non è stato specificato al- 
cun indice, quindi f array aveva un indice numerico intero predefinito. È tuttavia 
possibile specificare un proprio indice numerico o persino utilizzare delle stringhe. 
Per esempio: 

$shapes = array( 

1 immagine '=> 

array ( " stella" , "sole" , "ruota" , "fiore" , "macchia") , 

1 dimensione '=> array(50, 100,25,125, 158) , 
'quantità'=> array(8, 4, 14,3,2) 

); 



Nell'esempio precedente • In» UM (iti Hi •'"•'>' ha un valore di indice: immagine, 
dimensione e quantità Quella • '» Wgue è una riscrittura dello script precedente 
per illustrare come si possono Utilizzate questi indici: 

<table border='1 '> 
«tr> 

<?php 

//Array - Esempio 14-10 

m.- 

Sshapes = array{ 

1 immagine '=> 

nrray( "stella", "sole" , "ruota" , "fiore" , "macchia") , 

1 dimensione '=> array(50, 100,25,125,150) , 
'quantità'=> array (8,4,14,3,2) 

fóreach($shapes[ 'immagine' ] as $key=>$shape){ 
$size=$shapes[ 'dimensione' ] [$key] ; 
$quantity=$shapes[ 'quantità' ] [$key] ; 
echo("<td valign='top'>" ) ; 
for($count=0;$count<$quantity;$count++) 

echo("<img src='graphics/$shape. jpg' width= '$size ' 

height='$size'><br>") ; 

echo("</td>"); 

) 

?> 

</tr></table> 

I/output di questo script è lo stesso della Figura 14.11. È anche possibile specificare 

I valori di indice per ciascun elemento dell'array, come si è visto per l'array a una di- 
mensione. Quello che segue è un esempio di quanto appena detto: 

Sshapes = array( 

' immagine '=> 

a r r ay ( 1 => " stella " , 2=> " sole " , 3=> " ruota " , 4=> " fiore " , 5=> " macchia"), 
' dimensione ' => array ( 1 =>50 , 2=>1 00 , 3=>25 , 4=>1 25 , 5=>1 50 ) , 
' quantità ' => array ( 1 =>8 , 2=>4 , 3=>1 4 , 4=>3 , 5=>2 ) 

P 

II codice precedente specifica che gli indici degli elementi degli array iniziano da 
valore numerico 1 invece che da 0. 



Riepilogo 

Questo capitolo ha introdotto il concetto di array, mostrando come creare array ; 
mia dimensione e multidimetulonall 6 Come visualizzarne il contenuto. Nel prassi 
mo capitolo si vedrà come il |»" 1 " I edere Bill) data e all'ora del sistema. 



Capitolo 15 

Date, ore e numeri casuali 




Introduzione 

La capacità di accedere all'ora e alla data di sistema è molto utile. Date e ore posso- 
no essere utilizzate per diverse operazioni, dalla semplice visualizzazione della data 
e dell'ora corrette sulla pagina Web alla creazione di un'indicazione del momento 
in cui un record di database è stato creato. Inoltre, si vedrà che la capacità di evi- 
denziare l'ora è essenziale per consentire la creazione di numeri casuali. Questo ca- 
pitolo introdurrà alcune funzioni chiave coinvolte nell'accesso alla data e all'ora e il- 
lustrerà com'è possibile creare numeri casuali. 



Ottenere data e ora 

L'accesso alla data e all'ora può avvenire attraverso una singola funzione chiamata 
getdate(). 

La sintassi della funzione è la seguente, 
array getdate() ; 

La funzione gettiate () restituisce un array contenente la data e l'ora corrente. 
Questo array è indicizzato tramite stringhe; i valori di indice e il contenuto sono il- 
lustrati nella Tabella 15.1. 



Tabella 15.1 L'array getdate() 



Nome 


Descrizione 


seconds 


La parte dei secondi dell'ora corrente. 


minutes 


La parte dei minuti dell'ora corrente. 


hours 


La pkrM delle ore dell'ora corrente. 


mday 


( in uni i del mese. 


wday 


Ciiiim i (talli settimana in formato numerico (domenica = 0). 


mon 


M.-m- mulini. <> 


year 


Alimi IIIIIIHTII il 


yday 


domo dell >■> formato numerico, per esempio 312. 


weekday 


i ,n uni nk'ILi «iiIiimiwi Mi Incubili) U'Miiiile, ossia "Monday", 


month 


M,-„ ,|, Il ili ••iii.iU ' ivi.) "May". 
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Segue un esempio della funzione: 
$date = getdate (); 

Lo script che segue illustra l'accesso agli elementi dell'array della funzione getdate ( ) : 
<?php 

// Date, ore e numeri casuali - Esempio 15-1 

$date = getdate(); 

Sseconds = $date[ ' seconds ' ] ; 
Sminutes = $date[ 'minutes' ] ; 
$hours = $date[ 'hours' ] ; 
$mday = $date[ 'mday' ] ; 
Swday = $date[ 'wday 1 ] ; 
$mon = $date[ 'mon' ] ; 
$year = $date[ 'year' ] ; 
$yday = $date[ 'yday' ] ; 
Sweekday = Sdate [ 'weekday' ) ; 
$month = $date [ 'month']; 

echo("Sono le ore Shours : Sminutes : $seconds<br>" ) ; 
echo("0ggi è il $mday/$mon/$year<br>" ) ; 

echo( "Siamo nel mese di Smonth e il giorno della settimana è $weekday<br>" ) ; 
echo("E il giorno Swday di 6 di questa settimana (dove domenica è 0)<br>");' 
echo( "Finora sono trascorsi Syday giorni di quest'anno."); 



?> 



Lo script richiama la funzione getdate ( ) e assegna ciascun elemento dell'array re- 
stituito a variabili separate per una maggiore chiarezza. Queste vengono poi visua- 
lizzate sulla pagina Web, come illustrato nella Figura 15.1. 



| 3 http://localhost/phpbook/esemprolS-l.php - Microsoft Internet Explorer 
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Figura 1 5. 1 

Valori di data e ora. 



Date, ore e numeri casuali 1 29 



Ovviamente la data e l'ora * lauallSOUl lui W «ttO computer saranno diverse da quel- 
le della figura, poiché Indicherai»™ • quando eseguirete lo script. Al momento questi 
dati non sono utilizzali In al. un modo, ma solo visualizzati; tuttavia più avanti in 
questo capitolo e nei capitoli successivi ne vedrete qualche utile applicazione. 

microtime 

La funzione getdate ( ) restituisce l'ora corrente al secondo più vicino. Benché si 
li atti di una funzione utile, potreste aver bisogno di un'indicazione oraria più preci- 
■>.i; questo è possibile con la funzione microtime ( ). 
La sintassi della funzione è la seguente. 

string microtime (void) 

La tabella seguente descrive il tipo di valore restituito dalla funzione. 



Nome Tipo Descrizione 

Restituzione di microtime () String Questa funzione restituisce una stringa co- 

stituita da due parti: "msec sec . 
Il valore di sec è il numero di secondi tra- 
scorsi dalla mezzanotte del 1 gennaio 1970. 
La parte msec della stringa è la frazione di mi- 
crosecondi del secondo non intero corrente. 

. 

Esempio di funzione: 
Ssecs = microtimeO; 

Lo script seguente illustra un esempio di utilizzo di questa funzione: 
<?php 

// Date, ore e numeri casuali - Esempio 15-2 
1/ h 

Ssecs = microtimeO ; 

echo(Ssecs) ; 

?> 

Lo script precedente richiama la funzione microtimeO e ne visualizza il contenu- 
to. Benché al momento la funzione microtime ( ) non mostri tutta la propria utilità, 
presto essa sarà evidente. Ritornerete a questa funzione più avanti nel capitolo, 
quando sarà studiata la generazione di numeri casuali, 

Verifica di una data 

A volte potreste volere che un utente inserisca una data. Sfortunatamente alcune 
Hate sono valide, mentre altre non li i H ini i < 1 insiderete le date seguenti: 



J] settembre 1402; 
|q aprile 1999; 



Solo alcune di esse sono valide, tuttavia è necessario un metodo per verificare que- 
sta condizione in uno script. Fortunatamente esiste la funzione checkdate( ), che 
restituisce TRUE se la data che le viene passata è valida e FALSE se non lo è. 
La sintassi della funzione è la seguente. 

bool checkdate(int mese, int giorno, int anno); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


mese 


int 


Il mese. 


giorno 


int 


Il giorno. 


anno 


int 


L'anno. 


Restituzione di checkdate() 


bool 


TRUE se la data è valida, FALSE se non lo è. 



Esempio di funzione: 



$date = checkdate(2,29,1402) ; 

La funzione riceve tre parametri interi, che rappresentano il mese, il giorno e l'anno 
della data. Lo script che segue illustra un esempio di utilizzo di questa funzione: 

<?php 

// Date, ore e numeri casuali - Esempio 15-3 

mf--- --- - 

$date = checkdate(2,29,1402) ; 
if ($date) 

echo( "Questa è una data valida!"); 

else 

echo( "Questa non è una data valida"); 

B 

Lo script passa la data del 29 febbraio 1402 alla funzione checkdate ( ) e poi visua- 
lizza un messaggio che indica se la data è o meno valida. Potete provare a cambiare 
la data passata alla funzione checkdate ( ) per vedere se le date indicate in prece- 
denza sono valide. 

Generazione di un numero casuale 

La capacità di generare numeri casuali è uno strumento utile in qualunque linguag- 
gio di programmazione; senza di essa, per esempio, i giochi diventerebbero molto 
prevedibili. 

In PHP i passaggi che portano alla generazione di un numero casuale sono due. Il 
primo riguarda l'inizializzazione con un parametro seme del generatore di numeri 
casuali con la funzione srand ( ) . 
La sintassi della l'unzione e l:i seguente. 



void srand (int seme); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


seme 

luciamone di srand () 


int 
void 


Seme casuale per il generatore di numeri casuali. 
Non restituisce alcunché. 



Esempio di funzione: 



srand(l) ; 

La funzione srand ( ) viene utilizzata per impostare il generatore di numeri casuali a 
una posizione casuale, prima di ottenere i numeri casuali necessari allo script. La man- 
canza di questa inizializzazione produrrà un insieme di numeri casuali prevedibile. Per 
inizializzare il generatore di numeri casuali occorre partire da un numero molto gran- 
de, che può essere ricavato utilizzando la funzione microtime ( ) ; essa permette di ot- 
tenere la parte in microsecondi del suo output e moltiplicarla per un numero molto al- 
to. Ciò è possibile con la seguente istmzione: 

srand( (doublé) microtime() * 1000000); 

Questa linea inizializza il generatore di numeri casuali con un numero casuale pro- 
dotto a partire dall'ora corrente ottenuta dalla funzione microtime ( ). Ora siete 
pronti per ottenere numeri casuali, e per questo utilizzerete la funzione rand ( ) . 
La sintassi della funzione è la seguente. 

int rand ([int inizio, int fine]); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


inizio 


int 


Facoltativo. Valore minimo del numero casuale 






da generare. 


fine 


int 


Facoltativo. Valore massimo del numero casuale 






da generare. 


Restituzione di rand () 


int 


Numero casuale. 



Esempio di funzione: 



rand (10, 1080) ; 

La funzione rand() può essere chiamata senza alcun parametro, nel qual caso re- 
stituisce un numero casuale i cui valori minimo e massimo sono al di fuori del vo- 
stro controllo. Potete tuttavia limitare l'intervallo dei numeri casuali prodotti inclu- 
dendo i parametri di inizio e fine. Per esempio: 

rand(l0,1000) ; 

Questa riga produrrà numeri . BSUali compresi tra 10 e 1000. Lo script che segue illu- 
stra l'utilizzo dello strumento di generazione di numeri casuali: 

<?php 

// Date, ore e numeri OMUlll 6«t«pto 16-4 

// 'JàlA^- 



srand( (doublé) microtiine() ' 1000000); 

SrandVal = rand(1 ,6) ; 

echo( "Numero casuale: SrandVal"); 



?> 




L'esempio precedente produce semplicemente un numero casuale compreso tra 1 e 
6, certamente nulla di particolarmente entusiasmante; se pensiamo però che la ge- 
nerazione di numeri casuali compresi tra 1 e 6 avviene comunemente nel mondo 
reale quando si gioca a dadi, la cosa assume un aspetto diverso. Vediamo allora se 
è possibile vivacizzare questo esempio. 

Esempio dei dadi 

In questo paragrafo verrà creata una pagina Web che visualizza il risultato del lan- 
cio di sei dadi a sei facce. La prima operazione da compiere è la creazione di sei im- 
magini di dadi, illustrate nella Figura 15.2. 
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Figura 1 5.2 

Immagini dei dadi. 



Queste immagini sono memorizzate nella sottodirectory graphics con i nomi l.jpg, 
2.jpg e così via. Consideriamo ora uno script creato per utilizzarle: 

ifp'. " ■ , . I.'. : .v".f > i . ' l)t) : V ^ " 

<?php 

// Date, ore e numeri casuali - Esempio 15-5 



rand( (doublé) microtime() * 1000000); 

randVal = rand(1 ,6) ; 

echo( "<img src='graphics/$randVal. j pg ' > " ) 

$randVal = rand(1,6); 

echo( "<img src='graphics/$randVal. jpg'>") 

SrandVal = rand(1 ,6) ; 

echo( "<img src='graphics/$randVal. jpg'>") 

$randVal = rand(1 ,6) ; 

echo ( " <img src= 1 graphics/$randVal . j pg 1 >" ) 

$randVal = rand(1 ,6) ; 

echo ( " <img src= ' graphics/SrandVal . j pg 1 >" ) 

SrandVal = rand(1 ,6) ; 

echo( "<img src= 'graphics/$randVal. jpg'>") 



Lo script precedente iniziali/za il generatore di numeri casuali r quindi i ititene nu- 
meri casuali compresi tra I e 6, che vengono memorizzati nella vai lui ilio trnndVal. 
Questo valori' viene |»>i insedio in un lag <img> per visuali//. ne Li n imagi 



ne del dado. L'opera/ion. vi Ip< tutu nel volte. L'output del programma prece- 
dente è illustrai., nella l Igura I i ) Se fate clic sul pulsante Aggiorna del browser, i 
dadi visualizzali cambleranno In modo casuale. 



3 http://localhost/phpbook/esemplol5-5,php- Microsoft Internet Explorer 




é] Operazi one completata 

Figura 15.3 

Esempio di lancio casuale di un dado. 

Benché la Figura 15.3 mostri che è possibile vivacizzare lo script di generazione di 
numeri casuali, quest'ultimo non compie ancora alcuna operazione particolarmente 
utile. Torniamo quindi alle funzioni per le date e creiamo uno script che produrrà 
un utile calendario. 



Implementazione di un calendario 

La Figura 15-4 illustra un semplice calendario del mese di aprile. 
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Figura 15.4 

Un semplice calendario. 

A dispetto della sua appaivi iti' -.empiii Uà questo calendario è in realtà piuttosto 
complesso. Per esempio, i yu uni ili l!;i wttlmuna da domenica a sabato appaiono il 
colonne fisse, menile il y iodi nti/l- > del un si può essere uno qualunque di 'l'u- 
sti. Nell'esempio di aprile il |""»" k'"">" UcIIh Heltlmana e giovedì, periamo è ne 
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cessano visualizzare diverse celle vuote fino a collocare un 1 nella colonna del gio- 
vedì. 

Per la creazione del calendario è necessario impiegare molte funzioni introdotte in 
questo capitolo: 




<table border=' 1 '■> 
<?php 

// Date, ore e numeri casuali - Esempio 15-6 

$date = getdatef) ; 
$mday = $date[ 'mday' ] ; 
$mon = $date[ 'mon' ] ; 
$wday = $date[ '«day' ] ; 
$month = $date['month' ] ; 
$year = $date[ 'year' ] ; 
$dayCount = Swday; 
$day = Smday; 
while($day > 0) 

$days[$day--] = SdayCount--; 
if($dayCount < 0) 

SdayCount = 6; 

} 

SdayCount = $wday; 
$day = $mday; 

if (checkdate($mon,31 ,$year) ) 

SlastDay = 31 ; 
elseif ( checkdate (Smon , 30 , Syear ) ) 

SlastDay = 38; 
elseif ( checkdate (Smon , 29 , Syear) ) 

SlastDay = 29; 
elseif ( checkdate ( Smon , 28 , Syear) ) 

SlastDay = 28; 
while (Sday <= SlastDay) 

$days[$day++) = $dayCount++; 
if (SdayCount > 6) 
SdayCount = 0; 

echo("<tr><td colspan='7' align='center'>$month</td></tr>") ; 
echo("<tr><td>Sun</td><td>Mon</td><td>Tue</td><td>Wed</td><td> 

Thu</td><td>Fri</td><td>Sat</td></tr>" ) ; 
SstartDay = 0; 
$d = $days[1 ] ; 
echo("<tr>"); 
while (SstartDay < $d) 

echo("<td></td>"); 
$startDay++; 

for ($d=1 ;Sd<=$lastDay;$d++){ 
if($d == Smday) 



echo("<td bgoolo- I ii|hti>luo'>$d</td>"); 

else 

echo("<td>$d</td>')i 

$startDay++j 

if (SstartDay > 6 && Sd < SlastDay) 

SstartDay = 0; 
echo("</tr><tr>"); 



ocho("</tr>"); 

fi? 

</table^ 

Li , script inizia con un tag di tabella e richiama la funzione getdate( ) per ottene 
il giorno, il mese, l'anno e il giorno numerico della settimana: 

<table border=' r> 
<?php 

Sdate = getdate(); 
Smday = Sdate [ 'mday' ] ; 
Smon = Sdate [ 'mon' ] ; 
Swday = Sdate [ 'wday' ] ; 
Smonth = Sdate [ 'month' ] ; 
Syear = $date[ 'year' ] ; 

Poi viene utilizzato un ciclo while per iniziare a popolare l'array $days, che cont 
ne il giorno della settimana numerico di ciascun giorno del mese. Questo eie 
while calcola il giorno della settimana per aitte le date a partire da quella correr 
sino all'inizio del mese: 

SdayCount = Swday; 
$day = Smday; 
while(Sday > 0) 

$days[$day- - ] = SdayCount--; 
if (SdayCount < 8) 

SdayCount =6; 

■Ei 

SdayCount = Swday; 
Sday = Smday; 

Nell'esempio l'array $days appare effettivamente così, con il 18 come giorno 
mese corrente, che è una domenica: 

\ questo punto viene utilizzata la funzione checkdate () per determinare qus 
I ultimo giorno del mese corrente, che potrebbe essere 31, 30, 29 o 28: 

if (checkdate($mon, 31 , Syear)) 

SlastDay = 31 ; 
olseif (checkdate (Smon, 30, Syear)) 

SlastDay = 30; 
olseif (checkdate (Smon, 29, Syonr) ) 

SlastDay = 29; 
•lseif (checkdate($mon,2n, 
SlastDay « 28; 



Il programma utilizza quindi un ciclo while per memorizzare ncll'array $days il 
giorno della settimana per tutte le date del mese, a partire da quella corrente: 

while ($day <= $lastDay) 
{ 

$days[$day++] = $dayCount++; 
if ($dayCount > 6) 
$dayCount = 0; 

| ■ ■■. , ■ ■ ^ : ' ' ' " 

Nell'esempio I'array $days appare come indicato di seguito. 
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L'array precedente indica che, mentre il primo giorno del mese è giovedì, l'ultimo 
cade di sabato, Per creare il resto della tabella del calendario dovranno essere visua- 
lizzate innanzi tutto le intestazioni di colonna, con il mese e i giorni della settimana: 



echo("<tr><td colspan="7' align=' center '>Smonth</td></tr>" ) ; 
echo("<tr><td>Sun</td><td>Mon</td><td>Tue</td><td>Wed</td><td> 
Thu</td><td>Fri</td><td>Sat</td></tr>" ) ; 

Poi si ricava la data del primo giorno della settimana dall'array $days e la si memo- 
rizza nella variabile $d. Viene utilizzato un ciclo while per produrre una tabella 
vuota, sino ad arrivare alla colonna del giorno della settimana corretto: 

$startDay = 0; 

$d = $days[1 ] ; 

echo("<tr>"); 

while ($startDay < $d) 

{ ■ 

echo("<td></td>"); 
$startDay++; 

y . 

A questo punto siete pronti a visualizzare tutti i giorni del mese, e per questo si ri- 
corre a un ciclo f or. Quando si raggiunge il giorno del mese corrente, il colore di 
sfondo della cella della tabella corrispondente è azzurro (come indica l'attributo 
lightblue) per evidenziarla: 

for ($d=1 ;$d<=$lastDay;$d++){ 
if($d == $mday) 

echo( "<td bgcolor= 1 lightblue '>$d</td>" ) ; 

else 

echò("<td>$d</td>");} 

Il ciclo contiene una condizione if che verifica quando si raggiunge la fine della 
settimana, ossia un sabato. 

Esso produce altresì un elemento di fine riga, per garantire la corretta formattazióne 
della tabella: 



$startDay++; 

if($startDay > 6 && $d < $lastDay) 



} 



SstartDay ■ Ci 
echo("</tr><tr>"); 



> 

ocho("</tr>") ; 
?> 

</table> 

L'output di questo script è illustrato nella Figura 15.5. Questo script potrebbe esse 
modificato, per esempio per consentire a un utente di fare clic su una data ci 
dev'essere immessa in un modulo. 
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Figura 15.5 

Output del calendario. 



Riepilogo 

Questo capitolo ha introdotto le funzioni che consentono di accedere alla data e 
di sistema. Si è visto come l'accesso all'ora sia molto importante per riuscire a ge 
rare numeri casuali. Il capitolo si è concluso con l'analisi della procedura atta a < 
are un calendario. Le funzioni di data e ora di questo capitolo hanno utilizzato ai 
per restituire i loro valori. Benché gli array siano stati introdotti nel capitolo pre 
dente, ora l'argomento verrà ripreso, soprattutto per considerare alcune funzioni 
sponibili per la loro manipl ilazlofle. 



Capitolo 16 

Manipolazione degli array 



Introduzione 

Nel Capitolo 14 è stato introdotto il concetto di array e fornito qualche esempio di 
come utilizzarli. Si è visto che PHP supporta sia i tipi di array a una dimensione sia 
quelli multidimensionali. Ma non è stato possibile esaurire l'argomento. Infatti, la li- 
breria di PHP contiene molte funzioni che aiutano a manipolare agevolmente gli ar- 
ray. Questo capitolo presenterà alcune di queste funzioni e illustrerà come utilizzar- 
le in modo che siano di aiuto nella programmazione. 

Conteggio degli elementi di un array 

In qualche caso potrebbe accadere che sia necessario contare il numero di elementi 
presenti in un array. Le funzioni sizeof () e count( ) offrono entrambe uno stru- 
mento utile allo scopo. 

La sintassi delle funzioni è indicata di seguito. 

int count(array Array); 
int sizeof (array Array); 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalle funzioni. 



Nome 


Tipo 


Descrizione 




Array 

Restituzione di count ( ) 
Restrizione di sizeof ( ) 


array 

int 

int 


L'array da utilizzare. 

La dimensione dell'array. 

La dimensione dell'array. 





Esempi di funzioni: 



$count = count(Sarray) ; 
Scount = sizeof (Sarrny) ; 



Lo script seguente Illustra l'utilizzo della l'unzione count ( ) pei . >n< I.. «Iimensio- 
ne dell'array, che viene poi utilizzata per controllare la termina/ e del ciclo for: 



<table border=' r><tr> 
<?php 

// Manipolazione degli arrav - Esempio 16-1 

// 



: array(0=>" pomodoro" , 1=>"piselli" , 2=>"peperone" , 3=> " funghi " j 
4=>" peperoncino" ) ; 

tor($item=0;$item<count($veg) ;$item++) 

echo( n <td><img src=' graphics/" . $veg[$item] . " . jpg'x/td>"); 
echo( "</tr><tr><td align=' center 1 colspan='". count($veg). '">L'array 
contiene ". count($veg). "elementi. </td></tr>" ) ; 

?> 

</table> 

Lo script visualizza anche un messaggio che indica il numero di elementi contenuti 
nell'array. Tale valore viene utilizzato per stabilire il numero di colonne su cui si do- 
vrebbe impostare l'attributo rowspan dell'elemento <TD>, per assicurare che la pri- 
ma cella della seconda riga della tabella occupi l'intera larghezza della tabella. In 
questo modo, il messaggio "L'array contiene..." sarà centrato nella tabella. L'output 
dello script precedente è illustrato nella Figura 16.1. 
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Figura 16.1 

Conteggio degli elementi di ui i 



Elementi casuali di un array 



Dopo aver creato un arra) di* Il ITO Itti, potreste volerne randomizzare il contenuto, 
collocando ogni elemento dell'ami) In una posizione casuale. La funzione shut- 
tle ( ) consente di ottenere qucsh i i Isultato in modo piuttosto agevole. 
La sintassi della funzione e la seguente. 

void shuffle(array Array); 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


Array 


array 


L'array da mescolare. 


Restituzione di shuf f le( ) 


void 


Non restituisce alcunché. 



Esempio di funzione: 



shuttle ($array) ; 

Affinché la funzione shuttle ( ) possa essere formattata correttamente, è necessario as- 
segnare al generatore di numeri casuali un parametro seme con la funzione srand ( ) , 
descritta nel Capitolo 15. Lo script che segue illustra l'utilizzo di questa funzione. 

<table border=' 1 '> 
<?php 

// Manipolazione degli array - Esempio 16-2 



srand (( doublé ) microt ime ( ) *1 000000 ) ; 

$veg = array (0=>"pomodoro" , 1=>"piselli" , 2=> " peperone " , 3=>"funghi", 
4=>"peperoncino" ) ; 

tor($count=0;$count<3;$count++){ 
echo("<tr>"); 
foreach($veg as Svegltem) 

echo("<td><img src='graphics/$vegltem. jpg'x/td>") ; 
echo("</tr>") ; 
shuff le($veg) ; 

</table> 

Lo script inizia assegnando un parametro seme al generatore di numeri casuali e 
prosegue con la creazione dell'array. Viene utilizzato un ciclo for con un ciclo 
f oreach annidato per visualizzare ire volte il contenuto dell'array. Dopo ogni itera- 
zione del ciclo for eatemo, viene Utilizzata una funzione shuttle () per rendere 
casuale il contenuto del Ciclo I OUtpUl di questo script visualizza il contenuto 

dell'array così come e m.ii Mu i poi mostro il contenuto dell'array altre due yol- 

i ct |„p„| a randomi/./a/M'in ' i hRurti 16 l llluttra un tipico output di questo script, 
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Figura 16.2 

Randomizzazione di un array. 



Selezione di elementi casuali 

Invece di randomizzare l'intero array, si potrebbe scegliere di mantenerlo così come 
è stato creato e di estrarne semplicemente un elemento casuale. A tal fine è possibi- 
le utilizzare la funzione array_and ( ). 
La sintassi della funzione è la seguente. 

mixed array_rand (array Array); 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 



Tipo 



Descrizione 



Array array 
Restituzione di array_rand( ) mixed 



L'array da cui ottenere un elemento casuale. 
Elemento casuale dell'array. 



Esempio di funzione: 
$pos = array_rand($veg) ; 

La funzione array_rand() riceve un array sotto forma di parametro e restituisce 
l'indice di un elemento casuale dell'array. La funzione arroy_rand( ) richiede an- 
che che il generatore di numeri . usuali venga inizializ/ai n un |.,.i,imrirn seme. 



l.o script che segue mostra I ullluxo ik llu funzione: 



<table border=' 1 '> 
<?php 

// Manipolazione degli array • Esempio 16-3 

m 

srand ( ( doublé ) microtime ( ) * 1 000000 ) ; 

$veg = array(0=>"pomodoro" , 1 => 11 piselli " , 2=>"peperone" , 3=> "funghi" , 

4=>" peperoncino" ) ; 
f or ($rows=8 ; $rows<3 ; $rows++) { 
echo( "<tr>" ) ; 

f or ($cols=0 ; $cols<5 ; $cols++) 
$pos = array_rand($veg) ; 

echo("<td><img src=' graphics/" . $veg[$pos] . " . jpg'x/td>") ; 

IWJf '}' : - :''■[■';}■■ ' ' ■ ■ 

echo("</tr>"); 

ì 
?> 

</table> 

Lo script inizia assegnando un parametro seme al generatore di numeri casuali e 
procede con la creazione di un array. Poi utilizza due cicli f or annidati per visualiz- 
zare tre righe contenenti cinque elementi casuali dell'array. La Figura 16.3 illustra 
l'output dello script precedente. 




Figura 16.3 

Estrazione di un elemento casuale da un array. 



Mentre l'esempi,, p,v, .-.Irni.-. mine mostrata nella li K u..« Ifl 1 m,.,,|,„, tutti eli 
casuali, e m molti casi gli stessi ortaggi compaiono più volte. 

Aggiunta di elementi alla fine di un array 

Dopo aver creato un array, potreste voler aggiungere qualche elemento nuovo alla 
fine d. esso. A questo scopo è possibile utilizzare il metodo seguente: 

$array[] $newltem; 

slrTaf ?;nnnT gn T nt v- P J" eCeC ! e n te àttr ?^ ìsC é » valore $newltem all'array 
Sarray. Se non si specifica l'indice dell'array in cui inserire il valore, quest'ultimo 

T<Sor^ZVT matìCamente ? Un elemem ° nUOVO alla «ne dell'array. Lo 
script che segue illustra un esempio di questa operazione: 

<table border='l '> ' 
<?php 

// Manipolazione degli array - Esempio 16-4 

echo( : <?n>^; 0=> '' POmOdOr °"' 1=> " PÌSellÌ "- 2=>"peperone", 3=>"f unghi» , ; 

for($rows=0;$rows<count($veg);$rows++){ 

echo("<td><img src=' graphics/" . $veg[$rows] . " . jpg '></td>" ) ; 

echo("</tr><tr>") ; 
$veg []=" peperoncino " ; 
for($rows=0;$rows<count($veg) ;Srows++) { 

^ echo("<td><img src=' graphics/" . $veg[$rows] . " . jpg 1 ></td>" ) ; 
echo("</tr>"); 

M'Jir r '?/^-V'-- ''IV ' •ì^^BÉÉfe 

</table> 

Per prima cosa, lo script crea un array e ne visualizza il contenuto con un ciclo f or 
Quindi viene aggiunto un elemento nuovo, "peperoncino", alla fine dell'array e il 
contenuto d, quest'ultimo viene visualizzato per la seconda volta. La Figura 16 4 

S^Zl^S^^ che ,,eIemento ~° vi- 



Attraversamento di un array 

PHP supporta cinque funzioni che servono ad "attraversare un array" (un'espressio- 
ne utilizzata per descrivere un requisito di programmazione semnd, , <ui si . vede e 
Si utilizza in qualche modo ciascun elemento dell'array). Il , „ I, , fon , nch è un 

esempio d. msiruu,, consente di attraversare un arra> ,,. . . ,. ,. . ,,,„ \2 

permette di attmyeware l'array solo in un'unica direzione .1. tln ,11, ' L e 

Azioni reseti). ntxt(),prev(), current() ed end() , , 
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Figura 16.4 

Aggiunta di un elemento alla fine di un array. 



•.postarsi facilmente da un elemento all'altro. La sintassi di queste funzioni è indicata 
di seguito. 

mtxed next(array Array) 
mixed prev( array Array) 
mixed current (array Array) 
mixed end (array Array) 
mixed reset (array Array) 

l.a taliella seguente descrive l'argomento e il tipo di valore restituito dalle funzioni. 



Nome 


Tipo 


Descrizione 


Array 


array 


L'array da attraversare. 


Restituzioni delle funzioni 


mixed 


Diversi valori degli elementi dell'array, 



Esempio di funzione: 
Selement end($array); 

l.a l'unzione next ( ) restitulsi e l'elemento dell'array nella posizione successiva cui 
mira il puntatore interno Ugll IIRB) M 1 1 Une dell'array viene restituito un valore nul- 
lo, Restituito l'elemento, il vili del puni.ih ne all'array avanza di 1. La funzione 

prev() restituisce l'elemenin pn'ii'ik'nl, • m puma il puntatore interno all'array. Se 

si raggiunge l'inizio dell ,111.11 11 nullo un valore 0, La l'unzione current ( ) 

restituisce l'elemento dell an Indirizza il puntatore e non sposta 

il puntatore interno, l,a I un ». 1 | i.mI pimiaiore all'array hm'i no alla line 



dell'array e restituisce l'ultimo elemento. La funzione reset () sposta il puntatore 
interno all'inizio dell'array e restituisce il valore del primo elemento. 
Lo script che segue mostra un esempio di attraversamento di un array: 

<table border='1 '.> 
<?php 

// Manipolazione degli array - Esempio 16-5 

' é^^^W^0é'^ : :';' 

Sveg = array (0=>" pomodoro" , 1=>"piselli" , 2=>" peperone " , 3=>"f unghi" , 
4=>"peperoncino" ) ; 

echo("<tr>"); 

reset($veg) ; 

$vegt = current($veg) ; 

while($vegt) 

echo( "<td><img src='graphics/Svegt. jpg'></td>"); 
$vegt = next($veg) ; 

■I 

echo( "</tr><tr>" ) ; 
$vegt = end($veg); 
while($vegt) 

{ 

echo ( " <td><img src= 1 graphics/$vegt . j pg 1 ></ td> " ) ; 
$vegt = prev($veg) ; 

'} : ■ ; . ■ W> t . ; . ,j ;„•] \t< 

echo{"</tr>" ) ; 
</table> 

Nello script viene dichiarato un array, mentre il puntatore all'array viene ripristinato. 
Si ottiene l'elemento corrente dell'array (il primo). Con un ciclo while si visualizza- 
no gli elementi dell'array e si ottiene l'elemento dell'array successivo. Alla fine 
dell'array, il puntatore viene impostato con la funzione end(). Un secondo ciclo 
while visualizza gli elementi dell'array e invoca la funzione prev( ) per attraversare 
nuovamente l'array. La Figura 16.5 mostra l'output dello script precedente. Come si 
può vedere, lo script è in grado di visualizzare il contenuto dell'array in ordine nor- 
male o inverso. 

Inserimento ed estrazione: 
creazione di una pila 

Gli array sono utilizzati per memorizzare le informazioni e, molto spesso, la quanti- 
tà di informazioni aumenta o diminuisce. Accade di frequente di avei e l'i isigenza di 
implementare un array che permetta di aggiungere e rimuovere i dati alla fine 
dell'array. 'l'ale operazione è conosciuta con il nome eli "lmplementmli ine «li una pi- 
la". L'aggiunta ili dati alla fine della pila è nota come "in-.t- t-m. . \\y ntN la rimo- 
zione di daii prende il nome di "estrazione". PHP comprende dui luHKlnnl l he con- 
sentono di luti rlre • ci esirarre i dati. 
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Figura I6.S 

Attraversamento di un array, 



La sintassi delle funzioni è indicata di seguito. 

mixed array_pop( array Array) 

int array_push( array Array, mixed Elemento_array) 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 



Tipo 



Descrizione 



Array array 

Elemento_array mixed 

Restituzione di array_pop( ) mixed 

Restituzione di array_push( ) mixed 



L'array da utilizzare per l'estrazione/inseri- 
mento. 

Singolo elemento dell'array. 

Valore memorizzato nell'ultimo elemento 

dell'array. 

Il numero di elementi memorizzati nell'array. 



Esempi di funzioni: 

$pop = array_pop($veg) ; 
array_push($veg,$push) ; 

La funzione array_pop( ) richiede un array come parametro, restituisce il valore 
memorizzato nell'ultimo elemento dell'array e riduce di 1 la dimensione dell'array. 
La funzione array push() richiede un array e il dato che si intende aggiungere 
all'array come parametro, I .i dimenatone dell'array viene aumentata di un elemento 
e il dato viene memori/Aito proprio In questo elemento. La l'unzione restituisce il 
numero di elementi me il 



Lo script seguente illustra l'utilizzo di queste funzioni. Esso inizia dichiarancli i un ar- 
ray di quattro elementi: 

Wy- ■ % 

<table border=' 1 '> 
<?php 

// Manipolazione degli array - Esempio 16-6 

"■•■'t : "' : v"TS"#>;';;;-:;;, ' &0$tfm£.\ 

$veg = array(0=>"pomodoro° , 1=>"piselli" , 2=>" peperone" , 3=>"f unghi" ) ; 
$push = "peperoncino"; 

echo( "<tr>" ) ; 
foreach($veg as $vegltem) 

echo("<td><img src= 1 graphics/$vegltem. jpg'x/td>"); 
echo("</tr>") ; 
$pop = array_pop($veg) ; 
echo( "<tr>" ) ; 
foreach($veg as $vegltem) 

echo( "<td><img src= 'graphics/$vegltem. jpg'></td>" ) ; 
echo("</tr>"); 
array_push($veg,$push) ; 
echo("<tr>") ; 
foreach{$veg as $vegltem) 

echo( "<td><img src= 'graphics/$vegltem. jpg'x/td>") ; 
echo("</tr>"); 

?> 

</table> 



Nello script viene creato un nuovo dato di nome $push che contiene la stringa "pe- 
peroncino", che sarà aggiunta successivamente all'array. Un ciclo f oreach consen- 
te eli visualizzare il contenuto dell'array, dopodiché viene invocata la funzione 
array_pop() per rimuovere l'ultimo elemento dall'array. Il contenuto dell'array 
viene nuovamente visualizzato per mostrare che l'ultimo elemento è stato rimosso. 
Infine viene chiamata la funzione array_push( ) per aggiungere la variabile $push 
alla fine dell'array. Il contenuto dell'array viene visualizzato ancora una volta per 
mostrare il nuovo contenuto dell'ultimo elemento. L'output creato dallo script pre- 
cedente è quello della Figura 16.6. 

■ 

Conteggio delle occorrenze 

Ogni tanto gli array contengono alcuni elementi identici. Per esempio, supponete di 
chiedere a cento persone qual è il loro ortaggio preferito e di memorizzare le rispo- 
ste nell'array. Una volta ottenuti i dati, dovete elaborarli per stabilire i risultati del 
sondaggio. La funzione array_count_values ( ) è uno strumento molto 
determinare il numero di elementi uguali contenuti in un array. 
Il sintassi della funzione è la seguente. 

array array_count_values( array Array) 
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Figura 16.6 

Inserimento ed estrazione. 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


Array 

Restituzione di array_ 
count_values( ) 


array 
array 


L'array in cui contare gli elementi uguali. 
Restituisce un array di valori che indicano il nume 
ro di occorrenze di un particolare elemento. 



Esempio eli funzione: 

$count = array_count_values($array) ; 

La funzione richiede un array come parametro e restituisce un array dei risultati. S( 
per esempio, è stato creato un array costituito dai seguenti elementi: 

$array = array ( "pomodoro" , "piselli" , "peperone" , "piselli" , "piselli" ) ; 

invocando la funzione array_count_values ( ) in questo modo: 

$count = array_count_values($array) ; 

si otterrà la creazione di un .m.i\ $<:ount . un il contenuto seguente: 
( "pomodoro"=>1 , "piselli"«>3,' 



i capitolo io 



Lo script che segue illustra la funzione array_count values( ) all'operai 

<table border='1 '> 
<?php 

// Manipolazione degli array - Esempio 16-7 

$veg = array ( "pomodoro" , "piselli" , "peperone" , "funghi" , "peperoncino" 



"piselli" , "peperone" , "funghi" , 
, "peperone" , "funghi" , "peperoncino" 
peperoncino" , "pomodoro" , " pomodoro" 
, "piselli" , "peperone" , "funghi" 
, "peperone" , "funghi" 
, "piselli" , "pomodoro 



"pomodoro 
"pomodoro 
"funghi", 
"pomodoro 
"pomodoro 
"pomodoro 
Scount = array_count_values($veg) ; 
echo( "<tr>" ) ; 

foreach($count as $vegItem=>$vegCount) 
echo("<td align=' center '><img 
src= 1 graphics /$veg Item. jpg 1 ><br>SvegCount</td>" ) ; 
echo("</tr>"); 

?> 

</table> 



, " pomodo 



ro" 



"pomodoro" , "piselli" , 
, "piselli" ) ; 



Lo script dichiara un array $veg costituito da ortaggi. Viene chiamata la funzione 
array_count_values( ) e questa crea un array di nome $count, che contiene il 
numero corrispondente di ogni ortaggio memorizzato nell'array $veg. Quindi il 
contenuto dell'array $count viene visualizzato con un ciclo foreach. Osservate 
che l'array $count utilizza come indice i nomi degli ortaggi presi dall'array $veg. 
L'output generato dallo script precedente è quello della Figura 16.7. 
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Figura 16.7 

Conteggio delle occorrenze in un array. 
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Ordinamento 

■U' ' """HHBw^" ' •i , )hi.'' ì ».'ji' | |i i.'i'fiK) 

Le funzioni sort ( ) e rsort ( ) servono per ordinare un array. La funzione sort ( ) 
\ lene utilizzata per ordinare un array in base a una sequenza numerica o alfabetica, 
Dal valore più basso al più alto. La funzione rsort ( ) ordinerà l'array dal valore più 
.ilio al più basso. La sintassi delle due funzioni è indicata di seguito. 

void sort (array Array) 
void rsort (array Array) 



Li labella seguente descrive l'argomento e il tipo di valore restituito dalle fun- 
zioni. 



Nome 




Tipo 


Descrizione 


Array 




array 


L'array da ordinare. 


Restituzione d 


sort( ) 


void 


Non restituisce alcunché. 


Restituzione d 


rsort ( ) 


void 


Non restituisce alcunché. 



i Sempi di funzioni: 

lort($letters) ; 
rsort ($letters) ; 

Entrambe le funzioni richiedono un array come parametro. Lo script che segue ino- 
ltra l'utilizzo delle due funzioni: 

<table border='1 '> 
• ?php 

// Manipolazione degli array - Esempio 16-8 
,// 

Iletters = array("b" , "d" , "c" , "a" , "1" , "f " , "e" , "h" , "g" ) ; 
ocho("<tr>"); 

foreach ($letters as $letter) 

echo( "<td align=' center' ><img src=' graphics /Slette r. jpg '></td>" ) ; 
•cho( "</tr>" ) ; 
■ort($letters) ; 
ocho( "<tr>" ) ; 

foreach($letters as Sletter) 

echo( "<td align= 'center '><img src= 'graphics /Sletter . jpg ' ></td>" ) ; 
ocho("</tr>"); 
rsort($letters) ; 
echo("<tr>") ; 

foreach($letters as Sletter) 

echo("<td align=' center '><img src='graphics/$letter. jpg'x/td>" ) ; 
«cho( "</tr>" ) ; 

?> 

</table> 



Lo script dichiara un ;u i.i> di ihhiw lieti-- iohIIIuKo da lettere ordinale in se- 
quenza casuale. Il (oiii. iiiiim drlUim ili//.tto, ordinato e visualizzato di 



nuovo, Quindi, l'array vieni- c mimmo in senso inverso e infine visualizzato. Per ren- 
dere più interessante l'output dello script è stata creata una serie di immagini che 
rappresentano le lettere presenti nell'array. La Tabella 16.1 illustra queste immagini 
e i nomi di file corrispondenti. 



Tabella 1 6. 1 Immagini delle lettere 



A 


f 


e 


0 


I 


¥ 


G 


U 


/ 


Mpg 


b.jpg 




d-jpg 


ejpg 


f-ipg 


gjpg 


h-jPg 


'•jPg 



La Figura 16.8 mostra l'output creato dallo script precedente. 




Figura 16.8 

Array ordinati. 



Ordinamento multiplo 

La funzione array_multisort() può essere utilizzata per ordinare più array con- 
temporaneamente, o un solo array multidimensionale. 
La sintassi della funzione è la seguente. 

bool array_ multisort(array Array, mixed flag) 



La tabella seguente descrive gli .ugomenii ,■ il lipo di valore restituito dalla fun 
/.ione. 



Nome Tipo Descrizione 



Array 


array 


L'array da ordinare. 


flag 


array 

. 


S0RT_ASC ordina in sequenza crescente. 
S0RT_DESC ordina in sequenza decrescenti 
SORT_REGULAR confronta gli elementi noi 
malm o*nrc* 

SORT_NUMERIC confronta gli elementi i 
modo numerico. 

SORT_STRING confronta gli elementi coni 
stringhe. 


Restituzione 


bool 


Restituisce TRUE se l'operazione di ordin; 


ili array_multisort( ) 




mento è riuscita o FALSE se si è verificai 
un errore. 



I .| :: j.i: i.j 

Esempio di funzione: 



array_multisort($veg[0] ,SORT_ASC, SORT_STRING, 
$veg[1 ] ,SORT_NUMERIC) ; 

La l'unzione array_multisort( ) restituisce TRUE o FALSE in base all'esito positivo < 
negativo dell'operazione di ordinamento. Esaminiamo un esempio dell'utilizzo c 
tale funzione: 

<table border='1 '> 
<?php 

// Manipolazione degli array - Esempio 16-9 

ir----- - 

Sveg = array ( array( "pomodoro" , "piselli" , "peperone" , "funghi" , 

"peperoncino" , "pomodoro" , "piselli" , "peperone" , "funghi" , 
"funghi" , "peperoncino" , "pomodoro" , "pomodoro" , "pomodoro" , 
"pomodoro", "piselli", "pomodoro" , "piselli"), 

array (10, 20, 30, 10, 20, 25, 35, 40, 35, 45, 50, 20, 25, 30, 

25,30,20,30)); 

echo( "<tr>" ) ; 

foreach($veg[0] as $vegltem) 

echo("<td align= ' center 'xirng src='graphics/$vegltem. j pg ' 
width='25' height='25'></td>") ; 
ocho( "</tr>" ) ; 
echo( "<tr>" ) ; 

foreach($veg[1 ] as $vegPrice) 

echo ( "<td align= 1 center ' >$vegPrice</td> " ) ; 
echo("</tr>"); 

array_multisort($veg[01 ,30RT_A8C, 80RT_STRING, $veg[ 1 ] ,SORT_NUMERIC) ; 
ocho("<tr>") ; 

foreach($veg[0] as $voqH»hi| 

echo("<td align-'otrìtor 1 ,i--»phice/$vegltem. jpg' width-'25' 

height- '25' ></td>" ) ; 
echo("</tr>"); 



echo( "<tr>" ) ; 

foreach($veg[1 ] as $vegPrice) 

echo( "<td align= 1 center 1 >$vegPrice</td> " ) ; 
echo("</tr>"); 

?> '. ■ . : '"" . :• ' ■ '*T 

</table> 

Lo script inizia dichiarando un array multidimensionale di nome $veg, composto da 
due array. Tali array memorizzano il nome e il prezzo delle verdure. Vengono utiliz- 
zati due cicli f oreach per visualizzare il contenuto dell'array in una tabella. Succes- 
sivamente, viene invocata una funzione array_multisort( ): 

array_multisort($veg[01 ,S0RT_ASC, SORT_STRING, $veg[1 ] ,SORT_NUMERIC) ; 

Alla funzione viene passato il primo array, $veg [0] , che dovrà essere ordinato in 
sequenza crescente e in base al valore di stringa. Il secondo array, $veg[ 1 ] , do- 
vrà essere ordinato in sequenza numerica. Quindi, il risultato dell'operazione di 
ordinamento sarà visualizzato con due cicli f oreach. L'output dello script prece- 
dente è visibile nella Figura 16.9- È importante sottolineare che la funzione 
array_multisort { ) non ordina il primo array e poi il secondo separatamente, 
dando come risultato ortaggi con prezzi inesatti. Infatti, le relazioni intercorrenti 
tra i dati di ciascun array vengono mantenute. L'operazione di ordinamento del 
secondo array consente di visualizzare tutti gli ortaggi di un certo tipo in base al 
prezzo. 
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ir 




V 


m 


# 


« 


% 


<"■-. 








# 










10 


20 


30 


10 


20 


25 


35 


40 


35 


45 


50 


20 


25 


30 1 


25 


30 


20 


30 


S 




% 


V 


V 


a 


è. 




M 


0 


* 


m 




m 


* 


* 
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10 


35 


45 


20 


50 


30 


40 


20 

... 


30 


30 


35 




20 f 25 


25j| 25 


30 



(Operazione completata 



__________ 



Figura 16.9 

Output dell'operazione di ordinamento multiplo. 



explode e implode 



Le ultime due funzioni introdotte nel capitolo sono: explode () e implode)), che 
permettono di convertire un array in una stringa delimitata e riconvertire la stringa 
in un array. Un utente potrebbe voler memorizzare l'array in un database o in un fi- 
le, e questo è un metodo pratico per estrarre e memorizzare i dati sotto forma di 
stringa. Inoltre, più avanti, si vedrà che il passaggio degli array all'interno dei modu- 
li comporta problemi e una delle possibili soluzioni è passare l'array sotto forma di 
stringa. 

La sintassi delle funzioni è indicata di seguito. 

array explode (string Separatore, string Stringa) 
string implode (string Separatore, array Array) 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 


Tipo 


Descrizione 


Array 


array 


L'array da implodere. 


Stringa 


string 


La stringa da esplodere. 


Separatore 


string 


Il carattere da utilizzare per separare i contenuti 






dell'array. 


Restituzione di explode ( ) 


array 


Un array di elementi esplosi. 


Restituzione di implode ( ) 


string 


Una string di elementi dell'array. 



Esempi di funzioni: 



Sstring = implode ( " | " ,$veg) ; 
SnewVeg = explode( " ] " ,$string) ; 

Lo script che segue illustra l'implosione di un array in una stringa che viene poi vi- 
sualizzata. 

La stringa viene poi riesplosa in un nuovo array e anch'esso viene visualizzato: 

<table border=' 1 '> 
<?php 

// Manipolazione degli array - Esempio 16-10 

------ 

$veg = array(0=>"pomodoro" , 1 =>" piselli" , 2=>" peperone " , 3=> " funghi " , 
4=>"peperoncino"); 

Sstring = implode ( " | " ,$veg) ; 

echo( "<tr><td align=' center' colspan='5' >$string</td></tr><tr>" ) ; 
SnewVeg = explode ( " | " , Sstring) ; 

f oreach($newVeg as Svegltem) 

echo( "<td><img src= 'graphics/ Svegltem. jpg'x/td>" ) ; 
echo("</tr>") ; 

?> 

</table> 



I JU V-dpiUJIU I O 



L'output dello script pivu-donie è mostrato nella L-'igura lo In 
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Figura 16.10 

Esplosione e implosione degli array. 



i-i- 




Riepilogo 

Questo capitolo ha ripreso il concetto di array. analizzando numerose funzioni con 
le quali è possibile manipolare in modi diversi i dati contenuti in queste strutture. 
Nel prossimo capitolo torneremo al tipo di dati stringa, introdotto nel Capitolo 8, e 
vedremo quali funzioni è possibile utilizzare per manipolare le stringhe. 



Capitolo 17 

Manipolazione 
delle stringhe 



Introduzione 

fel Capitolo 8 abbiamo introdotto il concetto di stringa e abbiamo mostrato come 
fi Inararle e utilizzarle. Le stringhe sono molto utilizzate in PHP ed esistono diverse 
finzioni create appositamente per aiutare l'utente a manipolarle. In questo capitolo 
i in isenteremo alcune di queste funzioni e ne spiegheremo l'utilizzo 

Calcolo della lunghezza di una stringa 

Probabilmente, la funzione per stringhe più comune è strlen( ), che consente di 

•mare il numero dt caratteri di una stringa, 
l D ••intassi della funzione è la seguente. 

Ini strlen(string inputString) ; 

| I tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



r° me Tipo Descrizione 

inputString string La stringa della quale si conta il numero di carat- 

teri. 

! "" yjc " ìe di Strlen < » int » "umero di caratteri contenuti nella stringa. 



ivipio di funzione: 
*e = strlen ($title) ; 

i esempio che segue utilizza strlen ( ) per controllare il titolo di un messaggio in- 
•' un fo T' 1 f 5 ' 1 *■ m-s..,,, ; , non devono superare i 60 caratteri, pertanto 

" v im P ed,re »8'« "«enti di Im Iure tic .11 i he superino la lunghezza consentita. 

Bphp 

// Manipolazione dello sti-ln U ha l»o«pio \i \ 
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Stitle = "Questo è il mio messaggio"; 
$size = strlen($title); 

if($size <= 60) { 

echo "La lunghezza del titolo è $size. Accettato"; 

} 

else { 

echo "La lunghezza del titolo è Ssize. Non accettato"; 

?> 

Per prima cosa, questo script esegue una verifica della variabile title, mediante la 
funzione strlen( ): 

$title = "Questo è il mio messaggio"; 
Ssize = strlen($title) ; 

Quindi, verifica la dimensione della stringa e visualizza un messaggio appropriato: 

if($size <= 60) { 

echo "La lunghezza del titolo è Ssize. Accettato"; 

} .Ac;$"i&A ■ s i ■ ■ ■ ■ q " 

else { 

echo "La lunghezza del titolo è $size. Non accettato"; 

ÌnÉÉ :; ' 

L'output dello script precedente è quello della Figura 17.1. 
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Figura 1 7. 1 

Verifica della lunghezza di una stringa. 



Esplosione/implosione di parti 
ed elementi della stringa 

La funzione explode( ) serve per creare un array di elementi punendo dalle pani di 
una stringa divise da un carattere separatore, Il separale in i»u ■ i-m un «Ingoio ca- 
rattere numero oppun una stringa, La funzione implodo!) • mi rado ili 
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explode() e vieni' utili//. n.i |>< i , ivare una siringa partendo dagli elementi di un 
array divisi da un separai, ne Nel < lapitolo 16 si trovano tutti i dettagli relativi a que- 
ste due funzioni, la cui sintassi è riportata di seguito. 

Array explode(string Separatore, string Stringa); 
String implode (string Separatore, array Array); 

Nell'esempio seguente è riportata una stringa compósta da nomi propri: si vuole 
creare una piccola tabella in cui ciascun nome occupi una riga diversa: 

<?php 

// Manipolazione delle stringhe - Esempio 17-2 

w<~ 



Snames = "mike Simon david mary"; 

Slist = explode(" ", Snames); 

Srows = count(Slist) ; 

echo "<table border=1 width=220><tr>" ; 

echo "<td bgcolor=' #999999' > Nomi</td></tr>" ; 

f or ($i=0 ; $i<$rows ; $i++) { 

echo "</tr><td> $list[$i] </td></tr>"; 

w> 

echo "</table>"; 



7> 



Innanzitutto lo script definisce una stringa e la esplode in un array: 

Snames = "mike simon david mary"; 
Slist = explode(" ", Snames); 

quindi, conta il numero di righe nell'array: 
Srows = count (Slist ) ; 

Infine, utilizza un ciclo f or per costruire la tabella che visualizzerà gli elementi di 
ogni array su righe diverse: 

echo "<table border=1 width=220><tr>" ; 

echo "<td bgcolor=' #999999' > Nomi</td></tr>" ; 

f or ( $i=0 ; $i<$rows ; $i++ ) { 

echo "</tr><td> $list[$i] </td></tr>"; 

1 

echo "</table>"; 
?> 

L'output dello seri pi e (|iiello «Iella l'Iguni 17.2. 
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Figura 17.2 

Esempio di esplosione. 



identificatore Identificatore, la funzione restituisce la parte della stringa input - 
String dalla prima occorrenza di Identificatore alla fine della stringa di input. 
La sintassi della funzione è la seguente. 

string strstr (string. inputstring, string Identificatore) 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


inputstring 
Identificatore 
Restituzione di strstr ( ) 


string 
string 
string 


La stringa da utilizzare. 
Identificatore di stringa. 
Parte di una stringa. 



Esempio di funzione: 

$email = ' user@example.coni' ; 
$domain = strstr($email, '§'); 

Lo script PHP che segue illustra l'utilizzo della funzione: 
<?php 

// Manipolazione delle stringhe - Esempio 17-3 

Semail = 'user@example.com' ; 
$domain = strstr($email, '&'); 
echo "$email<br>$domain" ; 

?> 
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! i lUtput dello script è il seguane 

UBGr@example . coni 
Ooxample.com 



Sostituzione di una parte di una strìnga 

[TI genere, la funzione str_replace( ) viene utilizzata per cambiare le parti di una 
•.lunga in un'altra. 

Lil sintassi della funzione è la seguente. 

•tring str_replace (string parteCercata, string parteSostituita, string 
Inizio) 

1 .1 tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


imrteCercata 


string 


Stringa da cercare. 


parteSostituita 


string 


Stringa con cui sostituire parteCercata. 


Inizio 


string 


Stringa su cui eseguire le operazioni. 


Reatituzione di str_replace( ) 


string 


Stringa modificata. 



Esempio di funzione: 



•toxt = "Ciao, questo è [b]testo in grassetto! /b] " ; 
Itext = str_replace("[b]","<b>",$text); 

< :. insiderate lo script seguente che utilizza questa funzione: 
«?php 

// Manipolazione delle stringhe - Esempio 17-4 
// 

•toxt = "Ciao, questo è [bjtesto in grassetto! /b] " ; 
tcho "$text"; 

Itext = str_replace("[b]","<b>",$text); 
•toxt = str_replace("[/b]","</b>",$text); 

ocho "<br><br>"; 
•oho "$text"; 

T> •''■(-.',■.; 

Otello script precederne si d. voli nvertirc i simboli [b] e [/b] della variabile 

Itext in <b> e </b>, In mndot 11' .I lOMo possa comparire in grassetto all'interno 
Bel browser Web. Innanzitutto, la HCtlpt cerai In parte [b] (Iella stringa e la sosti- 
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miscv con un tag <b>. Poi, la stringa [/b] viene sostituita con </b>. La Figura 17.3 
mostra l'output prodotto da questo script. 
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Ciao, questo è [b]testo ingrassetto[/b] 
Ciao, questo è testo in grassetto 



Figura 17.3 

Sostituzione di una parte della stringa 



-Li 




Ripetizione e inversione di una stringa 

Vi piacerebbe avere la possibilità di ripetere una stringa in modo automatico senza 
continui interventi manuali, oppure di invenire una stringa? Per queste situazioni 
sono disponibili due funzioni, la cui sintassi è riportata di seguito. 

string str_repeat ( string inputString, int Moltiplicatore); 
string strrev { string inputString); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle fun- 
zioni. 



Nome 


Tipo 


Descrizione 


inputString 
Moltiplicatore 

Restituzione di str_repeat( ) 
Restituzione di st rrev ( ) 


string 
int 

string 
string 


La stringa da utilizzare. 

Il numero di volte per cui si deve ripetere la 

stringa. 

Restituisce la stringa di input, ripemta tante 
volte quante ne sono definite dal moltiplica- 
tóre. . 
Restituisce la stringa di input invertita. 



Esempi di funzioni: 

$repeated = str_repeat ( SinputString, 5 ); 
$reverse = strrev ( SinputString ); 
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L'esempio seguente > m UN tabella con IO colonne. Ciò è possibile ripetendo la 
stringa <td>spazio</td • dtei I volt», come mostrato di seguito: 

<?php 

// Manipolazione delle stringhe - Esempio 17-5 

// - --. 



echo "<table border='1' height=10>"; 
echo "<tr>"; 



cho str_repeat( "<td width=50> </td>" ,10) ; 



echo "</tr>"; 
echo "</table>"; 



L'output dell'esempio è quello della Figura 17,4. 



3http://localhost/phpbook/esempiol7-5.php - Microsoft Internet Explorer 
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Figura 17.4 

Ripetizione di parte di una stringa (<td>spazio</td>). 



Conversione 

maiuscolo/minuscolo di una stringa 

Succede talvolta di dover convertire da minuscolo a maiuscolo, o viceversa, qual- 
che stringa utilizzata negli script. Le funzioni riportate di seguito sono molto utili, 
poiché aiutano a modificare i caratteri minuscoli o maiuscoli delle parole contenute' 
nelle stringhe o ad alterare il primo carattere di ogni parola della stringa. 
La sintassi delle funzioni e riporUltó di seguito, 

string strtoupper(i»pui.'.'fn/i(/i , 

string strtolower( input :;ti lng)\ 

string uef irst( input. '.V/ li 

string ucwords(inputSfrir>ui , 
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La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle fun- 
zioni. 

■ 

Nome Tipo Descrizione 



inputString string 

Output di strtoupper () string 

Output di strtolower () string 

Output di ucf irst () string 

Output di ucwords () string 



La stringa da utilizzare 

Converte la stringa di input in caratteri maiuscoli. 
Converte la stringa di input in caratteri minuscoli. 
Volge al maiuscolo il primo carattere della strin- 
ga di input. 

Volge al maiuscolo il primo carattere di ogni pa- 
rola contenuta nella stringa di input 



Esempi di funzioni: 

$text_upper = strtoupper($text) ; 
$text_lower = strtolower(Stext) ; 
$text_ufirst = ucfirst($text) ; 
$text_uwords = ucwords ($text ) ; 

Nell'esempio seguente è riportata una semplice stringa (una frase di cinque parole) 
e saranno utilizzate le funzioni per trasformare la stringa in diversi modi: 

<?php 

// Manipolazione delle stringhe - Esempio 17-6 



$text = "ciao questa è una STRINGA"; 

$text_upper = strtoupper(Stext) ; 
$text_lower = strtolower($text) ; 
$text_ufirst = ucf irst ($text) ; 
$text_uwords = ucwords(Stext) ; 

echo "Testo originale: $text <br><br>"; 

echo "Maiuscolo: $text_upper <br>"; 

echo "Minuscolo: $text_lower <br>"; 

echo "Primo carattere maiuscolo: $text_ufirst <br>"; 

echo "Primi caratteri tutti maiuscoli: Stext_uwords" ; 

" 

L'output dello script precedente è quello della Figura 17.5. 



Cifratura delle stringhe 

Esistono più di dieci metodi per cifrare le stringhe. La cifratura può essere a una via 
(non esiste la possibilità di decifrare la stringa) e a due vie (la panila cifrata può es- 
sere decifrata con il metodo del dizionario o altri metodi) In i|»u-si«i paragrafo sa- 
ranno presentali i quattro metodi di cifratura più Utilizzati Vlcunl di CMl vengono 
impiegati spesso pei verificare l'integrità di l'ile e d.m MDM ) \ i- ni null/zaia soprat- 
miio per ciliari li pumword nelle applica/ioni Web m. un. Crypt () •erve per crii 
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Testo originale: ciao questa è una STRINGA 



Maiuscolo: CIAO QUESTA E UNA STRINGA 
Minuscolo: ciao questa è una stringa 
Primo carattere maiuscolo: Ciao questa è una STPJNGA 
Primi caratteri tutti maiuscoli: Ciao Questa È Una STRINGA 



Figura I7.S 

Modifica delle lettere maiuscole/minuscole della stringa. 



tografare le password del sistema Linux. Le funzioni md5 ( ) e crypt ( ) sono analiz- 
zate anche nel Capitolo 20, che si occupa dei problemi legati alla protezione dei da- 
ti. La sintassi delle funzioni è riportata di seguito. 

String md5(string inputString); 
string shal (string inputString); 
int crc32(string inputString); 

string crypt(string inputString , string Opzione); 



La tabella seguente 
/.ioni. 



descrive gli argomenti e il tipo di valore restituito dalle fun- 



Nome 


Tipo 


Descrizione 


inputString 


string 


La stringa da utilizzare. 


Opzione 


string 


CRYPT_STD_DES. Cifratura DES standard in bloc- 
chi di due caratteri. 

CRYPT_EXT_DES. Cifratura DES estesa in blocchi 
di nove caratteri. 

CRYPT_MD5. Cifratura MD5 in blocchi di 12 carat- 
teri che inizia con $1 $. 

CRYPT_BLOWFISH. Cifratura Blowfish in blocchi 
di 16 caratteri che inizia con $2$. 


Restituzione di md5 ( ) 


string 


Una stringa lunga 32 bit contenente la stringa di 
input cifrata. 


Restituzione di shal ( ) 


string 


1 Ina stringa di 40 caratteri contenente la stringa 
■ li InpUI cifrata. 


Restituzione di crc32( ) 


int 


i MI •.ninna contenente il polinomio crc32 della 

Mingi di input. 


Restituzione di crypt ( ) 


•trino 


1 ru KlinBn di 40 caratteri contenente la stringa 
iti mimi < llr.ua. 



168 Capitolo VI 



Esempi di funzioni; 

$encrypt = md5($inputStrìng) ; 
Sencrypt = shal (SinputString) ; 
$crc = crc32($inputString) ; 
Sencrypt = crypt(SinputString) ; 

Prendendo la stringa test come valore di $inputString, dopo la cifratura avremo 
i risultati seguenti: 

md5 ($inputString): 098f6bcd4621d373cade4e832627b4f6 

shal (linputstring): a 94a8fe5ccbl9ba6lc4c0873d391e987982fbbd3 

Crc32($inputString): -662733300 

Crypt ($inputString): $iSLD1.2H2.$9kNYlkYWiNiWbomSR73kR. 

Lo script che segue illustra un semplice esempio di verifica della password con il 
metodo della codifica MD5: 

<?php 

// Manipolazione delle stringhe - Esempio 17-7 

$my_pass = "377729"; 
$md5_pass = md5($my_pass) ; 

if ( isset ($_P0ST[ " submit " ] ) ) { 

Sspass = md5($_P0ST["password"]); 

if($spass == $md5_pass){ 

echo "Password accettata!"; 
}else{ 

echo "Password errata!"; 

,rf ; ';' • 

} 

<html> 

<body bgcolor="#FFFFFF" text=" #000000 "> ■ 
<form name="form1 " method="post" 
action="<?php echo $_SERVER[ "PHP_SELF" ] ; ?>"> 

Verifica password: 

<input type="text" name=" password "> 

<input type=" submit" name=" submit" value="Invia"> 

</form> 
</body> 
</html> 

ìn questo script abbiamo cifrato la password 377729 con il mei. kIo MI >5: 

$my pass = "377729" ; 
$md5_pas8 ■ mdB($my_p«M); 
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Lo script cifra In pBMWOtd Inoltrata (377728) e la confronta con quella cifrata in 
precedenza. Se le .siringhe confrontate sono Identiche, si può autorizzare l'utente a 
stabilire la connessi) mei 

$spass = md5($_P0ST[ "password"]); 

if($spass == $md5_pass){ 

echo "Password accettata!"; 
}else{ 

echo "Password errata!"; 

[1; } 

L'output dello script è quello della Figura 17.6. 
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Password erratal 



Verifica password: 



Figura 17.6 

Semplice esempio di verifica della password. 




Conteggio delle parole 



La funzione str_word_count( ) conta il numero di parole contenute in una stringa. 
La sintassi della funzione è la seguente, 

mixed str_word_count(string inputString , int Modalità) 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 



Tipo 



Descrizione 



inputString 
Modalità 



•.i i uni 
Liti 



kc.SlilU/.ione ili si r wm ,1 , I 



La stringa da utilizzare. 

I restituisce un array contenente tutte le 
parole trovale all'interno della stringa; 

restituisce un array associativo, in cui la 
. lu ne !• la posi/ione numerica della paro- 

I I i" Hit stringa e il valore e la panila stessa. 
■ Ih mix lulltii non £ specilli aia, \ Isuullzza 

il immilli lutale ili panile presemi nella 

mom 'ii miiut 
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Esempio di funzione: 

Scount = str_word_count($string,1 ) ; 

Se non si specifica alcuna modalità, il risultato sarà un numero che indica quante pa- 
role sono state trovate all'interno della stringa; se la modalità è impostata a "1", il ri- 
sultato sarà un array contenente tutte le parole trovate all'interno della stringa, men- 
tre se la modalità è impostata a "2", il risultato sarà un array associativo, in cui la chia- 
ve è la posizione numerica della parola nella stringa e il valore è la parola stessa. 

Aggiunta e rimozione delle barre 

A volte, lavorando con un database si avverte l'esigenza di aggiungere alcuni carat- 
teri, come l'apostrofo ('), le virgolette ("), le barre contrarie (\) e NULL (il byte 
NULL). La funzione utilizzata per aggiungere questi caratteri è addslashes( ). Se 
invece si desidera rimuovere le barre, è possibile ricorrere alla funzione strip - 
slashes( ). 

La sintassi delle funzioni è riportato di seguito. 

string addslashes(string inputString) ; 
string stripslashes(string inputString); 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalle fun- 
zioni. 



Nome 


Tipo 


Descrizione 


inputString 

Restituzione di addslashes() 
Restituzione di stripslashes{ ) 


string 

string 
string 


Stringa su cui eseguire le operazioni 
con le barre. 

Stringa con i caratteri di escape, 
Stringa con le barre rimosse. 


Esempi di funzioni: 







$escapedString = addslashes(SinputString); 
$normalString = stripslashes($inputString) ; 

Conversione di caratteri speciali 
in entità HTML 

In HTML alcuni caratteri hanno un significato particolare e dovrebbero essere rap- 
presentati da entità HTML, se si desidera conservarlo. La funzione htmlspecial- 
chars() restituisce una stringa con questi caratteri convertiti nei rispettivi codici 
HTML. 

La sintassi della funzione è la seguente. 

string htfllXl i<tlch«ri(8tring inputString); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


inputString 


string 


Stringa su cui eseguire le operazioni. 


Restituzione di htmlspe- 


string 


Stringa con codifica HTML. 


cialcharacters() 





Esempio di funzione: 



ShtmlEncoded = htmlspecialchars($inputString) ; 

Le conversioni eseguite sono le seguenti: 
& (e commerciale) diventa ' &amp ; ' . 

" (virgolette) diventa 1 &quot ; 1 quando ENT_N0QUOTES non è impostato. 
• (apostrofo) diventa 1 &#039; 1 solo quando ENT_QU0TES è impostato. 
< (minore di) diventa ' &lt ; ' . 
> (maggiore di) diventa ' &gt ; 1 . 
Lo script che segue illustra l'utilizzo di questa funzione: 

<?php 

// Manipolazione delle stringhe - Esempio 17-8 

w- 

SoriginalString = "& < > \" V"; 

ShtmlEncoded = htmlspecialchars($originalString) ; 

echo "Originale: SoriginalString <br> Codificata: ShtmlEncoded"; 

Slen = strlen (SoriginalString) ; 
$len2 = strlen (ShtmlEncoded) ; . 

echo "<br>Lunghezza originale: Slen <br> Lunghezza codificata: $len2"; 
?> 

L'output di questo script è quello della Figura 17.7. 

Notate che nell'esempio della Figura 17.7 l'output di testo è lo stesso in entrambi i 
casi. Ciò dipende dal fatto che un browser Web visualizza una "&" e una "&amp" 
come una "&". Tuttavia si può affermare che la conversione è avvenuta perché la 
lunghezza delle due stringhe è diversa. 

Confronto di stringhe con diverse 
impostazioni di maiuscolo/minuscolo 

A volte è necessario nu li. i. tlrlnglH-diver.se per vedere se contengono 

le stesse pinole, ,i pi.-- I< " tbilfc .llll«<>«ii/<- di maiuscole/minuscole l'ei esem 
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Figura 1 7.7 

Esempi di caratteri speciali HTML. 

pio, si vuole poter dire che la stringa "Simon" è identica a "sIMON". A tal fine è pos- 
sibile utilizzare la funzione strncasecmp( ) . 
La sintassi della funzione è la seguente. 

string strncasecmp(string Stringai, string Stringa2, int Lunghezza); 

■ 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


Stringai 
Stringa2 
Lunghezza 

Restituzione di strncasecamp( ) 


string 
string 
int 

int 


Prima stringa da confrontare. 

Seconda stringa da confrontare. 

Numero dei caratteri in ciascuna stringa da 

utilizzare nel confronto. 

Restituisce 0 se le stringhe sono uguali. 


Esempio di funzione: 






Sequal = strncasecmp( "Simon 


', "SIMON", 


5); 


Riepilogo 







Questo capitolo ha ripreso il concetto di stringa. Sono state analizzate numerose 
funzioni con le quali è possibile manipolare in modi diversi i dati contenuti nelle 
stringhe. Le funzioni qui presentate sono quelle più utilizzate dai programmatori, 
tuttavia esistono più di venti funzioni di stringa diverse utilizzabili per applicazioni 
e script più specifici. Nel prossimo capitolo verrà introdotto il concetto dell'intera- 
zione con l'utente; si spiegherà in che modo le applicazioni l'I 11' pi issano interagire 
con gli utenti finali e le operazioni disponibili. 
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Interazione con Putente 



1 8 Interazione con Putente 

1 9 Convalida dei moduli e conservazione dei dati 

20 Problemi di sicurezza 

2 1 Invio di messaggi di posta elettronica 



Capitolo 18 

Interazione con l'utente 



Introduzione 

I programmi che non offrono alcuna forma di interazione con gli utenti hanno pos- 
tillila di impiego molto limitate. PHP è in grado di interagire con un utente me- 
nile una pagina Web che utilizza i moduli, I moduli consentono di inserire i dati 
4 Inoltrarli al server cosicché possano essere elaborati da PHP. Esistono moduli di 
igni forma e dimensione; alcuni sono facili da identificare in quanto tali, altri sono 
m i ovvi. In questo capitolo introdurremo i principi fondamentali e mostreremo 
Oimc combinarli per consentire interazioni piuttosto complesse. 



PHP e i moduli 

I un ululi sono un componente di HTML, non di PHP. Anche se PHP può visualizza- 
li' I moduli nello stesso modo in cui visualizza tutti gli altri elementi HTML, in realtà 
tu ni aggiunge nulla di nuovo alle funzionalità offerte dal linguaggio HTML standard. 
l'Ili' può essere però utilizzato per controllare i moduli ed elaborare i dati forniti 
nll'utente nell'interazione con il modulo, un'operazione che HTML non è in grado 

II fare. Dato che PHP è un linguaggio di scripting sul lato server, i dati dei moduli 
Bevi ino essere trasmessi al server per essere elaborati, dopodiché l'output generato 
Sovra essere nuovamente inviato all'utente. Una differenza notevole rispetto alle 
modalità di utilizzo di JavaScript, dove l'elaborazione può essere eseguita sul com- 
piaci- del client all'interno del browser. 

Un modulo semplice 

Il primo passo sarà la creazione di un modulo HTML standard e la specificazione di 
alcuni elementi dell'immissione di dati. Considerate lo script seguente: 

<html> 

|. Interazione con l'utento • iMMOlO 16 I ■> 
\ « •* 



i iq capitolo ia 



<body> 

<h2>Inserire i propri dati personali :</h2> 
<form action='esempiolB-2,php' method='post'> 

Nome: <input type='text' name='f irstname'» 
<br> 

Cognome: <input type='text' name='surname'> 
<br> 

Nome utente: <input type='text' name='username'> 
<br> 

Password: <input type=' password ' name=' password" > 
<br> 

<input type= ' submit ' > 

</form> 
</body> 
</html> 

Questo .script è un documento HTML, non uno script PHP, pertanto deve essere Sal- 
valo con l'estensione .html. Lo script mostra gli elementi fondamentali di un modu- 
li' 1 1 1 MI., Innanzitutto, il modulo inizia con un elemento <f orm>, che ha due attri- 
buii Chiave: action e method. L'attributo action specifica dove inviare i dati del 
modulo per l'elaborazione: potrebbe trattarsi un'applicazione CGI Scritta con qua- 
lunque linguaggio di programmazione, oppure potrebbe essere uno script PHP 
i Itlrll un, i method specifica come inviare i dati del modulo all'applicazione. I meto- 

•'' sono due > P0ST e GET. PHP supporta POST, quindi è necessario utiliz- 

questo metodo. 

Noli esempio, l'elemento del modulo specifica che lo script per elaborare i dati del 
mi M lui) I Si Chiama esempio 1 8-2. php, che però non esiste ancora: 

«forni action* 'esempio18-2.php' method='post'> 

La parie restante del modulo è costituita da quattro campi per l'immissione dei dati 
tre dei quali sono del tipo text e uno di tipo password: 

Nome: <input type='text' name='firstname'> 
<br> 

jrr. ' . ' ". ■; ■'r-y.fv -<h.u>y>> ■■••.■V-;:. .■■ 

Cognome: <input type=. 1 text ' name='surnanie'> 

<br> 

Nome utente: <input type='text' name='username'> 
<br> 

Password: <input type=' password' name=' password '> 
<br> 

In pratica si tratta dello stesso tipo di campi per l'immissioni- dati, i ninne per il fatto 
che i campi password nascondono i dati in essi contentili \ Isualizziindo al loro po- 
sio caraiteri •. Osservate che ogni campo di input del dati ha .... nome ipoclflco, che 

e sialo scello per rappresentare i dati relativi a . ias< un rlcm.-ni,, mi del campi 

modulo sono importanti, poiché serviranno per | u l| IR .|| 0 

script PHP. Il modulo finisce con un campo di input di H|h. iuMU 



<input type-' submit '> 
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Questo campo è ih-< . \<>- -..unir all'ulenle di inoltrare i dati del modulo 

dopo averlo completato, L'i lUlpUl delti i W tipi I ITML precedente è illustrato nella Fi- 
gura 18.1. In pratica, si traila ili eli i i he l ITML è in grado di fare con i moduli. Più 
avanti nel capitolo si vedrò die esiste qualche altro tipo di campo per i moduli 
HTML; se però volete utilizzare In qualche modo i dati del modulo, è necessario co- 
minciare a creare uno script PI IP che gestisca le informazioni inserite. 
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Figura 18.1 

Un modulo semplice. 

A questo punto create uno script PHP che gestisca i dati passati al server attraverso 
il modulo. Lo script è molto semplice, poiché l'unica operazione che esegue è vi- 
sualizzare i dati ricevuti, come mostrato nella Figura 18.2. 

<?php 

// Interazione con l'utente - Esempio 18-2 

// ------ • -• ., .. >>M 



$firstname = $_POST[ "f irstname" ] ; 
$surname = $_POST[ "surname" ] ; 
$username = $_P0ST[ "username" ] ; 
Spassword = $_POST[ "password"] ; 

echo("Ciao $f irstname $Burname<br>" ) ; 

echo("Il tuo nomo uttnt» è Sutiername e la tua password è $password"); 
?> 

Accedere ai dati del modulo <■ moli. , mpli. e (,)uando si crea un modulo, contem- 
ponmeanu-nk- vini- ....">• un nmiy «»»«h lato di variabili, che prende il nome di 
$_P0ST. Ogni elemento ili i mmjlIuIu ITIMI < un un nome univoco viene memorizza- 
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Ciao Simon Stobart 

Il tuo nome utente è simonl234 e la tua password è james5678 



. ■ i ; 1< M r~-f anet Idi 



--.Ini xl 




Figura 18.2 

Output dei dati del modulo. 



to nell'array e vi si può accedere con lo script PHP. Per accedere all'elemento del 
modulo f ìrstname, per esempio, utilizzate la sintassi seguente: 



Sfirstname = $_P0ST[ "firstname" ] ; 



Combinazione di moduli e PHP 

Nell'esempio precedente, il modulo HTML e lo script PHP sono stali scritti come 
due Me separati. Il primo conteneva il modulo HTML, il secondo lo script PHP ne- 
cessario per elaborare i dati. Non è sicuramente il modo migliore di implementare 
questa soluzione, poiché è difficile fare nuovamente riferimento al modulo so- 
prattutto se I utente deve reinserire qualche dato nuovo. Il metodo migliore consi- 
ste nel combinare il modulo e PHP elaborandoli insieme nello stesso script come 
mostrato di seguito: ' 

<html> 
<body> 

<h2>Inserire i propri dati personali:</h2> 
<form action='esempio18-3.php' method="post 1 > 

Nome: <input type='text' name=' firstname ■> 
<br> 

Cognome: <input type='text' name=' su marne' > 
<br> 

Nome utente: <input type='text' name= " username ' > 
<br> 

Password: <input type=' password' name=' password '> 
<br> 

<input type='submit'> 



</form> 
</body> 



• /niml> 
plphp 

// interazione con l'utente • Esempio 18-3 



M n-stname = S_P0ST[ "firstname" ] ; 
liurname = $_POST[ "surname" ] ; 
incornarne = $_POST[ "username" ] ; 
•password = $_POST[ "password" ] ; 

toho("Ciao $firstname $surname<br>" ) ; 

tcho("Il tuo nome utente è $username e la tua password è $password"); 
?> 

Lo script precedente associa il modulo HTML e lo script PHP in un unico punto. 

i Lillavia, come mostrato nella Figura 18.3, quando lo script viene elaborato sorge 
un problema: il modulo viene infatti visualizzato prima che le istruzioni echo siano 

itale elaborate. 
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Inserire i propri dati personali 



Nome: 



Cognome: | 
Nome utente: | 
Password: 

n 



si 



Nolice: TJndefined index: firstname in e:\inetpub\wwwroot\phpbook\esempiol8-3.php on line 23 

Notice. TJndefined index: surname in e:\inetpub\wwwroot\phpbook\esempiol8-3.php online 24 

Notìce: TJndefined index: username in e:\inetpub\wwwroot\phpbook\esempiol8-3.php online 25 

Notice: TJndefined index: password in e:\inetpub\wwwroot\phpbook\esempiol8-3.php on line 26 
Ciao 

Il tuo nome utente è e la tua password è 




Figura 18.3 

Il problema del modulo. 



Dopoché il modulo è stato Inviato perla prima volta, questo pioblnn.i unii sussiste 
più; tuttavia, la prima volta che si carica la pagina le variabili del modulo non con- 
tengono alcun dato, e questo comporta la visualizzazione ili un messaggio incom- 
pleto. Quello di cui avete bisogno è uno strumento per stabilire se i dati del modulo 
siano stati o meno inviati. Considerate lo script seguente: 

<html> 
<body> 

<h2>Inserire i propri dati personali:</h2> 

<f oriti action='<?php echo $_SERVER[ "PHP_SELF" ] ; ?>' method='post' > 

Nome: <input type='text' name='firstname l > 
<br> 

Cognome: <input type='text' name='surname l > 
<br> 

Nome utente: <input type='text' name='username l > 
<br> 

Password: <input type=' password 1 name=' password" > 
<br> 

<input type=" submit' name='submit'> 

</form> 
</body> 
</html> 

<?php 

// Interazione con l'utente - Esempio 18-4 

<:N--r : i; , .,' 

if (isset ($_POST [ " submit " ] ) ) { 

$firstname = $_POST[ "firstname" ] ; 
$su marne = $_POST[ "su marne" ] ; 
Susername = $_P0ST[ "username" ] ; 
Spassword = $_POST[ "password" ] ; 

echo("Ciao $firstname $surname<br>" ) ; 
^ echo("Il tuo nome utente è $username e la tua password è $password"); 

In pratica si tratta dello script precedente riscritto in modo da risolvere il problema 
della visualizzazione di valori nulli, quando il modulo non è ancora stato inviato. La 
prima modifica apportata al programma non ha nulla a che fare con questo proble- 
ma, ma semplifica notevolmente il lavoro dello sviluppatore. La modifica sostituisce 
il nome del programma che viene invocato con la variabile PHP_SELF: 

<?php echo $^SERVER[ "PHP_SELF"] ; ?> 

Si tratta di una variabile del server (introdotta nel Capitolo 9) che contiene il nome 
dello script corrente; questa variabile fa sì che lo script chiami sempre se stesso, a 



prescindere dal nome con cui è stato salvato. La modifica successiva serve per asse- 
gnare un nome al pulsante di invio: 

<input type= ' submit ' name=' submit 1 > 

In questo caso, il nome è stato impostato a submit. Infine, è stata inserita un'istru- 
zione if per controllare il risultato della chiamata alla funzione isset (), già 
disc usso nel Capitolo 9. 

La sintassi della funzione è la seguente. 

R <fl - \. :<S\:i. .<: 

lnt isset (mixed Valore); 

La tabella seguente descrive l'argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


Valore 

Restituzione di isset () 


mixed 
int 


La variabile di cui dev'essere verificata l'esistenza. 
TRUE se la variabile esiste, FALSE in caso contrario. 



Esempio di funzione: 

$set = isset ($_P0ST[ "submit"]); 

La funzione richiede il passaggio di una variabile e prowederà successivamente a 
controllare se tale variabile è stata o meno impostata. Se la variabile è stata imposta- 
la, la funzione restituisce un valore TRUE, altrimenti restituisce un valore FALSE. 
Il programma controlla che il valore della variabile $submit sia stato impostato. Ciò 
è possibile solo se il modulo è stato inviato, risolvendo il problema, come mostrato 
m'Ha Figura 18.4. 
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Inserire i propri dati personali: 



Nome: 

Cognome: 
Nome utente: 
Password: | 



Invia query | 



Figura 18.4 

Soluzione del problema deb" 



io/ capitolo ih 



Calcolatore di monete 

Finora gli esempi 1 1* - 1 moduli sono stati molto semplici. Si natia ora ili creare qualco- 
sa di più interessante. Lo script che segue illustra un modulo molto semplice asso- 
ciato a una funzione "utile": consente Infatti a un utente di inserire un valore me- 
diante un campo del modulo e di inviarlo. Il valore in questione rappresenta un 
prezzo, Per esempio, 134 rappresenta 1 euro e 34 centesimi, mentre 56 rappresenta 
56 centesimi. Lo script calcola il numero minimo di monete necessario per raggiun- 
gere l'importo inserito mediante il modulo. Il programma utilizza le immagini (sal- 
vate nella directory di immagini) della Tabella 18.1, 



Tabella 1 8. 1 Immagini e noni di file delle monete. 



































Icjpg 


2c.jpg 


5c.jpg 


lOcjpg 


20c.jpg 


50c.jpg 


100c.jpg 


200c.jpg 



Osservate lo script che permette di ottenere questo risultato: 

<h2>Calcolatore del numero minimo di monete</h2> 
<form action='<?php echo $_SERVER[ "PHP_SELF" ] ; ?>' method='post'> 
Inserire l'importo: <input type='text' name='amount'> 
<input type='submit'> 
</form> 

<?php 

// Interazione con l'utente - Esempio 18-5 

//__ . . ...... 

if (isset($_POST[ " amount" ] ) ) 

coins ($_P0ST[ "amount"] ); 

function coins($amount) { 

while (éamount >= 200 ){ 

$amount=$amount -200 ; 

echo( "<img src='graphics/200c. j pg ' > " ) ; 
} // ciclo while 
while($amount >= 100) { 

$amount=$amount - 1 00 ; 

echo("<img src='graphics/100c. jpg'>"); 
} // ciclo while 
while ($amount >= 50) { 

$amount=$amount -50 ; 

echo ( " <img src= ' graphics/50c . j pg ' >" ) ; 
} // ciclo while 
while ($amount >= 20) { 

Samount =$amount- 20; 

ocho( "<img src= ' graphics /20c. jpg'>" ) ; 
} // ciclo while 



■ 



while($amount >= 10) ( 

$amount=$amount -10; 

echo("<img sre- ' graphics /1 Oc. j pg ' > " ) ; 
} // ciclo while 
while ($amount >= 5){ 

$amount=$amount-5; 

echo("<img src='graphics/5c. jpg'>") ; 
} // ciclo while 
while ($amount >= 2){ 

$amount=$amount-2; 

echo ( " <img src= ' g raphics / 2c . j pg ' > " ) ; 
} // ciclo while 
if($amount > 0){ 

echo("<img src='gi~aphics/1c.jpg'>") ; 

} f ' ; ' vii 



Lo script inizia visualizzando un semplice modulo costituito da un campo per l'im- 
missione di testo e da un pulsante di invio: 

<h2>Calcolatore del numero minimo di monete</h2> 

<form action='<?php echo $_SERVER[ "PHP_SELF" ] ; ?>' method= ' post ' > 

Inserire l'importo: <input type='text' name=' amount '> 

<input type='submit'> 

</form> 

Innanzitutto lo script PHP controlla la variabile $amount per stabilire se è stato inseri- 
to un importo mediante il modulo. Se questa variabile è impostata, viene invocata la 
funzione coins ( ) , alla quale viene passato il valore dell'importo inserito nel modulo: 

Ir i 1 ■ 

<?php 



if ( isset ($_P0ST [ " amount " ] ) ) 

coins($_POST[ "amount" ]) ; 

La funzione coins ( ) calcola quali immagini delle monete visualizzare. Tale funzio- 
ne è costituita da alcuni cicli while, che sottraggono il valore della moneta attual- 
mente elaborata dall'importo totale. La funzione è progettata per sottrarre prima i 
valori delle monete che valgono di più, in modo da calcolare il numero minimo di 
monete necessario a eguagliare il valore inserito: 

function coins ($amount) { 

while (Samount >= 200 ){ 

$amount=$amount -200 ; 

echo("<img src='graphics/200c. jpg'>") ; 
} // ciclo while 
while (Samount >= 1O0){ 

$amount=$amount-100; 

echo("<img src='graphics/l00c. jpg'>") ; 
} // ciclo while 
while (Samount >■ M){ 

$amounf$Mi<»"" M| 

echo ('< imo •' >c " QrtphiOI/Mo. jpo'*") ! 
} // ciclo whlll 



while (Samount >■ 20){ 

$amount=$amount-20; 

echo ( " <img src= ' graphics/20c . j pg ' > " ) ; 
} // ciclo while 
while($amount >= 10){ 

$anount=$amount - 1 0 ; 

echo ( "<img src= 1 graphics / 1 0c. j pg ' >" ) ; 
} // ciclo while 
while ($amount >= 5){ 

$amount=$amount -5 ; 

echo( "<img src='graphics/5c. j pg ' > " ) ; 
} // ciclo while 
while (Samount >= 2){ 

$amount=$amount-2; 

echo ( " <img src= 1 graph ics / 2c . j pg 1 > " ) ; 
} // ciclo while 
if($amount > 0){ 

echo("<img src='graphics/1c.ipg'>") ; 

> ' ■;. 

> i r&liii - ij ;« l'i ,. v 

Alla prima esecuzione, l'output ottenuto dal programma precedente è uguale a 
quello illustrato nella Figura 18.5. 
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Figura 18.5 

L'input dell'utente per il calcolatore di monete. 



Se l'utente immette un valore nel campo modulo e fa clic sul pulsante Invia query, 
il programma calcola il numero minimo di monete necessario per raggiungere l'im- 
porto specificato. Per esempio, se l'utente digita 99 (che rappresenta 99 centesimi), 
ottiene l'output della Figura 18.6. 
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Figura 18.6 

L'output del calcolatore di monete. 



Pulsanti di opzione 

Oltre ai campi di testo e password e al pulsante di invio introdotti finora, esistono 
molti altri tipi di campi. Il primo è il campo di opzione, che non consente all'utente 
di inserire del testo, ma fornisce una serie di pulsanti di opzione tra i quali l'utente 
può scegliere. Si può selezionare solo uno dei pulsanti raggruppati. Per essere certi 
che il modulo sappia quali pulsanti formano un gruppo, tutti i pulsanti raggnippati 
devono avere lo stesso nome. Lo script che segue illustra un esempio del campo di 
opzione: 

<form action='<?php echo $_SERVER[ "PHP_SELF" ] ; ?>' method= ' post 1 > 

<h2>Seleziona il tuo colore preferito:</h2> 
Blu <input type=' radio 1 name='col' value='blu'> 
Verde <input type=' radio' name='col' value=' verde" > 
Giallo <input type=' radio' name='col' value=' giallo '> 
Rosso <input type=' radio' name='col' value=' rosso '> 
<br> 

<h2>Seleziona il tipo di musica che pref erisci:</h2> 
Pop <input type=' radio' riamo- 'mus' value='pop'> 
Rock <input type='radio' namo«'mui' value-'rock'> 
Classica <input type- ' radio" nnmn-'mutT value-'classica'> 
<br><br> 



<input type-'submir namo-'iubmlf> 



</form> 
<?php 

// Interazione con l'utente - Esempio 18-6 

if (isset($_POST["submit"] >) 

$col = $_POST["col"] ; 
$mus = $_POST["mus"] ; 

echo("Il tuo colore preferito è il $col<br>"); 
echo("La musica che preferisci è $mus"); 

> 



Lo script visualizza due gruppi di pulsanti di opzione, uno chiamato "col" l'altro 
"mus". 

Viene effettuato un controllo per stabilire se il pulsante di invio è stato premuto e, in 
caso affermativo, vengono visualizzati i valori memorizzati nelle variabili $col e $mus. 
L'output ottenuto dall'esecuzione dello script precedente è mostrato nella Figura 18.7. 
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5» 



Campi caselle di controllo 



I campi caselle di controllo permettono all'utente di selezionare tutte le opzioni che 
richiede al modulo. A ogni casella di controllo viene assegnato un nome univoco. 
Lo script che segue illustra un esempio dell'impiego del campo casella di controllo: 

<html> 
<body> 

<fonn action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method='post'> 

<h2>Seleziona tutti i colori che ti piacciono :</h2> 
Blu <input type='checkbox' name='cb1' value='blu'> 
Verde <input type='checkbox' name='cb2' value=' verde '> 
Giallo <input type='checkbox' name='cb3' value=' giallo '> 
Rosso <input type= ' checkbox 1 name='cb4' value=' rosso '> 
<br><br> 

<input type='submit' name=' submit '> 

</form> 
</body> 

. -: l5> 

?php 

// Interazione con l'utente - Esempio 18-7 




if (isset ($_P0ST[ "submit" ] ) ) 

|". 

if (isset($_P0ST["cb1"])) 
$cb1 = $_P0ST["cb1"]; 

else 

$cb1 = ""j 
if (isset ($_P0ST["cb2"])) 
$cb2 = $_P0ST["cb2"]; 

else 

$cb2 = " " ; 
if (isset ($_P0ST["cb3"])) 
$cb3 = $_P0ST["cb3"]; 

else 

$cb3 = " "•; 
if ( isset ($_P0ST["cb4"])) 
$cb4 = $_P0ST["cb4"]; 

else 

$cb4 = ""; 

echo("I colori che ti piacciono sono $cb1 $cb2 $cb3 $cb4"); 

?> 

Lo script visuali/./;i un modulo l MipOStO da quattro caselle di controllo, che rap 
presentano colori divertii Ùl UH «ti IffM I WCBtodi selezionare un colore qualsiasi 
Se il pulsante eli imi-' - ■«-»■- ■ pieni.. i" viikoiio visualizzati i valori delle variabil 
dolio caselle di coni rollo (lobi. Igbft, |0b3 c $0b4). 
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Figura 18.8 

Campi caselle di controllo. 



Campi di selezione 

Il campo di selezione del modulo utilizza un formato diverso, rispetto agli altri campi 
modulo incontrati in precedenza. Esso utilizza due elementi HTML: select e op- 
tion. Ogni volta che volete visualizzare il menu di selezione a discesa, dovete inse- 
rire un elemento option all'interno dell'elemento select. Dato che ogni elemento 
option comprende tutti i dati, non c'è alcun bisogno di inserire attributi per i valori. 
Nello script seguente è mostrato un esempio dell'utilizzo di questo elemento: 

<form action='<?phzp echo($_SERVER[ "PHP_SELF" ] ) ?>' method=' post 1 > 
Selezionare il proprio titolo: <select name='title'> 

<option>Sig.</option> 
<option>Sig . ra</option> 
<option>Dr.</option> 
<option>lng.</option> 
<option>Prof . </option> 
</select> 

<br><br> 

<input type='submit l name= ' submit 1 > 
</form> 

<?php 

// Interazione con l'utente - Esempio 18-8 
// 

if ( isset ($_P0ST [ 11 submit " ] ) ) { 
Stitle = $_POST["title"]; 
echo("Il titolo scelto è Stitle"); 

} 



7> 



Lo script visualizza un modulo composto da un solo menu di selezione, di nome 
title, costituito da una selezione di titoli, e verifica se il pulsante di invio è stato 
premuto e, in caso affermativo, visualizza il valore $title. L'output ottenuto 
dall'esecuzione dello script precedente è quello della Figura 18.9. 
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Figura 18.9 

Campi di selezione. 



Campi textarea 

L'elemento textarea (ossia area di testo) del modulo consente di creare una casella di 
testo composta da un certo numero di righe e colonne. Considerate lo script seguente: 

<?php 



// Interazione con l'utente • Esempio 18-9 

. 

if ( isset ($_P0ST [ " submit " ] ) ) { 
if ($_POST["address"] == "") 
SaddressErr = 1 ; 

} 



<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method='post'> 
<h2>Inserire i propri dati personali: </h2> 
Indirizzo: <textarea name='address' rows= '5'></textarea> 
<?php 

if (i9set($addressErr) ) 

echo("<font color»' red ' size='2'> Inserire un 
lndlrlza:o</font>"); 

?> 

<br><br> 

<input type=' submit • namn- -, 



I TV V-ilUILUlU I O 



Lo script visuali//;i un modulo costituito da un campo tcxtnron All'Utente vie- 
ni' chiesto di inserire il proprio indirizzo nel campo. Se il | itilsanlc ili Invio viene 
premuto senza che nell'area di testo sia stato inserito qualcosa, compare un 
messaggio che invila l'utente B inserire un indirizzo. La Figura 18.10 mostra l'ou- 
tput di questo seri pi. 
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Figura 18.10 

Campi textarea. 



Campi immagine 

I mi iduli possono anche elaborare le immagini come campi di input. Anche se que- 
sta affermazione di primo acchito può sembrare strana, provate a considerare l'im- 
magine illustrata nella Figura 18.11, che è composta da tre pulsanti. 




Figura 18.11 

Immagine dei pulsanti. 



Il campo immagine del modulo è rappresentato nello script seguente. Il programma 
non comprende un pulsante di invio, poiché quando l'utente fa clic sull'immagine, 
le coordinate x e y del punto in cui l'utente ha fatto clic vengono trasmesse allo 
script. 

Questi valori sono memorizzati in due variabili, denominate rispettivamente 
pulsante_x e pulsante_y, poiché al campo è stato assegnato il nome pul- 
sante: 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method='post'> 
Fare clic sull 1 immagine :<br> 

<input type='image' src=' graphics/pulsanti^jpg 1 name=' pulsante '> 
</form> 

<?php 

// Interazione con l'utente - Esempio 18-10 



if (isset<$_POST["pulsante_x"])){ 

if ($_POST["pulsante_x"] > 22 && $_P0ST[ "pulsante_x" ] < 210 && 
$_POST["pulsante_y"] < 155 && $_P0ST[ "pulsante_y" ] > 100) 
echo("Hai fatto clic sul pulsante blu."); 

else 

echo("Hai fatto clic sull'immagine."); 

n> ' 
?> 

Lo script precedente visualizza l'immagine come campo immagine del modulo. 
Dato che manca un pulsante di invio, l'unica azione in grado di inviare il modulo è 
il clic dell'utente sull'immagine. 

Quando l'utente fa clic sull'immagine, lo script verifica i valori X e Y passati come 
variabili pulsante_x e pulsante_y per stabilire se l'utente ha fatto clic sul pul- 
sante blu (quello in mezzo) e visualizza un messaggio di conferma, come mostra- 
to nella Figura 18.12. È possibile stabilire se l'utente ha fatto clic sul pulsante cen- 
trale, poiché è noto che l'angolo in alto a sinistra del pulsante si trova nella posi- 
zione 22 x 100, mentre l'angolo in basso a destra occupa la posizione 210 x 155 
dell'immagine. 

Se i valori memorizzati in pulsante_x e pulsante_y sono compresi in questi in- 
tervalli, significa che l'utente ha fatto clic sul pulsante in questione. 

Caricamenti di file 

I moduli possono utilizzare un elemento che permette all'utente di selezionare 
un file dal computer locale e di caricarlo nel server, in modo che lo script PHP 
l-ossa accedervi. Si tratta di un processo complesso, analizzato in dettaglio nel 
Capitolo 28. 




Figura 18.12 

Output del campo immagine. 



Riepilogo 

Questo capitolo ha spiegato come utilizzare PHP per interagire con l'utente attra- 
verso i moduli HTML. Sono stati presentati i diversi elementi dei moduli e sono stati 
illustrati i metodi per estrarre i dati contenuti negli elementi. Tuttavia, l'interazione 
con l'utente non si limita alla possibilità di visualizzare un modulo e accedere ai dati 
in esso contenuti. Il prossimo capitolo affronterà il molo della convalida dei dati dei 
moduli e della rivisualizzazione dei dati dei moduli. 




Capitolo 19 

Convalida dei moduli 



e conservazione dei dati 

y 

Introduzione 

L'interazione con l'utente è efficace se i dati che egli ha inserito sono effettivamente 
quelli richiesti. Come è noto, può accadere che gli utenti digitino informazioni non 
richieste, pertanto la convalida dei dati dei moduli è fondamentale. Provate a imma- 
ginare che cosa accadrebbe se, tra i dati inseriti nel modulo, si riscontrasse un erro- 
re: dovreste dare all'utente la possibilità di visualizzare nuovamente il modulo, in 
modo da poter correggere l'errore. 

Tuttavia sarebbe una grande perdita di tempo se l'utente fosse costretto a inserire 
nuovamente tutti i dati del modulo, compresi quelli corretti. È necessario pertanto 
uno strumento che consenta di conservare e rivisualizzare i dati dei moduli. Questo 
i apitolo spiega come convalidare e come rivisualizzare i dati dei moduli. 

Convalida di presenza o assenza 

1 Ina delle forme più semplici di convalida consiste nello stabilire se l'utente ha inse- 
rito o meno un qualche dato in un campo del modulo. Controllare che un campo di 
testo o password contenga informazione equivale a verificare se la variabile creata 
dal campo modulo ha lunghezza zero. A tal fine si può utilizzare un'istruzione ìf 
come la seguente: 

il 

if ($variable == "") 

Nel caso di un campo di selezione, le cose sono leggermente diverse; infatti, di de- 
fault, la prima voce del menu è selezionata automaticamente. Questa impostazione 
non crea alcun problema se questa voce è ciò che l'utente vuole, ma se l'utente non 
Intende selezionare tale elemento e si è persino dimenticato di inserirlo, la situazio- 
ne si complica; per risolverla è possibile inserire una voce di menu "falsa" all'inizio 
del menu stesso. Sua e.ssiv.imente potete controllare il valore della variabile di que- 
sta voce e scanalili qualora ventosa trovata. 



I.o script che segue illusi r:i l;i « . «valida di un elemento di selezione del modulo. 
<?php 

// Convalida dei moduli e conservazione dei dati - Esempio 19-1 

if (isset($_POST[ "submit" ] ) ){ 

if($_POST["title»] == "Selezionare...") 

StitErr = 1; 
else 

StitErr = 0; 
if($_POST["firstname"] == "») 

$f irstErr = 1 ; 

'^firstErr = 0; 
if($_POST[ "stimarne"] == "") 

$surErr = 1; 
else 

SsurErr = 0; 
if (isset($_POST["mus"])) 

. if ($_POST["itius"] == '"') 
$musErr = 1 ; 
else 

SmusErr = 0; 

} 

else 

SmusErr = 1 ; 



■nì',; 



ì 

else { 

StitErr = 0; 
SfirstErr = 0; 
SsurErr = 0; 
SmusErr = 0; 

} 

?> 

<fornt action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method=' post '> 

<h2>Inserire i propri dati personali:</h2> 
Titolo: <select name='title'> 

<option>Selezionare. . .</option> 

<option>Sig . </option> 

<option>Sig . ra</option> 

<option>Dr.</option> 

<option>Ing.</option> 

<option>Prof .</option> 

</select> 



?> 



echo("<font color='red' size='2'> Selezionare untitolo</font>" ) ; 



<br> 
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Nome: <input type='text' name=' fir8tname'> 
<?php 
if (SfirstErr) 

echo("<font color='red' size='2'> Inserire il nome</font>" ) ; 

?> 

<br> 

Cognome: <input type='text' name='surname'> 
<?php 
if (SsurErr) 

echo("<font color='red' size='2'> Inserire il cognome</font>" ) ; 

?> 

<br> 

<h2>Selezionare il genere musicale pref erito :</h2> 
Pop <input type=' radio' name='mus' value='pop'> 
Rock <input type=' radio' name='mus' value=' rock'> 
Classica <input type=' radio' name='mus' value=' classica '> 
<?php 

if (SmusErr) 

echo("<font color='red' size='2'> Selezionare il genere 
musicale pref erito</font>" ) ; 

?> 

<br><br> 

<input type= ' submit ' name=' submit '> 
</form> 

Lo script inizia stabilendo se il modulo è stato inviato. In caso affermativo, il valore 
title, una voce del modulo di selezione, viene controllato per vedere se equivale 
ìli valore "Seleziona... ". Si tratta della prima opzione di menu e non è un input va- 
lido. Le tre istruzioni if successive verificano se i valori f irstname, surname e mus 
sono vuoti. Se qualche variabile del modulo è vuota, le variabili di errore corrispon- 
denti vengono impostate a 1 . 

■r • 

<?php 

// Convalida dei moduli e conservazione dei dati - Esempio 19-1 
■L------ 

if(isset($_POST[ "submit" ])){ 

if($_POST["title"] == "Selezionare...") 



StitErr = 1 ; 
else 

StitErr = 0; 
if($_POST["f irstname"] == "") 
SfirstErr = 1; 

6lS6 

SfirstErr ■ 0; 
if ($_P0ST["8urnamV| « "") 
SsurErr ■ 1[ 

else 

SsurErr • I; 
if (i880t($ P08I !*■»<• * |M 

B < 

if ($ Molti**»' i ' > 
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SmusErr - 1; 

else 

SmusErr = 0; 

} 

else 

$musErr = 1 ; 

> 

else { 

$titErr =0; 
SfirstErr = 0; 
SsurErr = 0; 
$rausErr = 0; 

} 

?> 



La parte successiva dello script visualizza il modulo e il suo primo elemento, il cam- 
po di selezione: 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' n)ethod='post'> 

<h2>Inserire i propri dati personali:</h2> 
Titolo: <select name='title'> 

<option>Selezionare. . .</option> 

<option>Sig.</option> 

<option>Sig. ra</option> 

<option>Dr.</option> 

<option>Ing.</option> 

<option>Prof .</option> 

</select> 

Lfl parli- successiva controlla il valore della variabile $titErr (la variabile impostata 
nel raso in cui si rilevi un errore), e se tale valore è 1 visualizza un messaggio di er- 
rore: 

<?php 
if($titErr) 

echo("<font color='red' size='2'> Selezionare untitolo</font>" ) ; 

?> 

La parte finale dello script visualizza gli altri tre campi del modulo e controlla le va- 
riabili di errore corrispondenti ($f irstErr, $surErr e $musErr) per decidere se 
visualizzare o meno un messaggio di errore. 

<br> 

Nome: <input type='text' name='fir striarne' > 
<?php 
if ($firstErr) 

echo("<font color='red' size='2'> Inserire il nome</font>" ) ; 

?> 

<br> 

Cognome: <input type='text' name='surname'> 
<?php 
if (SsurErr) 

echo("<font color- 'red' aize-'J?' • li <>gnomo</font>" ) ; 

?> 



«-olivano.» aoi moquii ■ corwervazi one gei aau 



ivi 



<br> 

<h2>Selezionare il genero munlcnlo preferito :</h2> 
Pop <input type=' radio' natnO"'mua' value='pop'> 
l <input type=' radio' naoit» 'inus ' value= ' rock ' > 



sica <input type='radio' name='mus' value=' classica '> 
<?php 

if (SmusErr) 

echo("<font color='red' size='2'> Selezionare il genere 
musicale pref erito</f ont>" ) ; 

?> 

<br><br> 

<input type='submit' name= 1 submit 1 > 
</form> 

La Figura 19-1 illustra l'output prodotto da questo script, in cui un utente si è dimen- 
ticato di inserire qualche dato nel modulo. 
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Pop Rock C Classica O Selezionare il genere musicale preferito 



Invia 



iaquety | 



s 



mgmmmmÈ». 



Figura 19.1 

Messaggi di errore per i dati dei moduli presenti o assenti. 



Convalida dell'intervallo 

Anche la convalida doli Inls pcnizli tue piuttosto semplice. Supponeie di 
chiedere all'utente «li ius< i ■• iUm liprcuo tra due numeri, per esempio il 



numero di procioni clic lui intenzione di acquistare. A tal lini poieir utilizzare una 
semplice istruzione if . Lo script seguente illustra come. 

<?php 

■ 

Il Convalida dei moduli e conservazione dei dati - Esempio 19-2 

if ( is s et ( $_P0ST [ " s u bmit " 1 ) ) { 

Spurchase = $_POST[ "purchase"] ; 
$purErr=0; 

if( $purchase < 1 |j Spurchase > 100) 
$purErr=1 ; 

else 

echo("Hai scelto di acquistare Spurchase prodotti."); 

else 

SpurErr=0; 

?> 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method='post'> 

<h2>Inserire un numero compreso tra 1 e 100</h2> 
Quantità da acquistare :<input type='text' name=' purchase '> 

<?php 
if (SpurErr) 

echo("<font color='red' size='2'> Valore non 
compreso nell ' intervallo</f ont>" ) ; 

?> 

<br><br> 

<input type='submit' name= 1 submit 1 > 
</form> 

Lo script inizia verificando se un modulo è stato inviato, quindi stabilisce se il valore 
memorizzato nella variabile del modulo $purchase è compreso nell'intervallo spe- 
cificato, ossia tra 1 e 100: 

if ( isset ( $_P0ST [" submit "])) { 

Spurchase = $_P0ST[ "purchase" ] ; 
SpurErr=0; 

if ( Spurchase < 1 Jj Spurchase > 100) 
SpurErr=1 ; 

else 

echo("Hai scelto di acquistare Spurchase prodotti."); 

} 

else 

$purErr=0; 

Se il valore rientra nell'intervallo stabilito, compare un messaggio con il numero dei 
prodotti che si desiderano acquistare. In caso contrario la variabile SpurErr viene 
impostata a 1, Poi viene visualizzato nuovamente il modulo • "ii un singolo campo 
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di testo e la richiesta di inserire un valore compreso tra 1 e 100. Se invece il valore 
di SpurErr è 1, compare un messaggio di errore: 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method=' post '> 



<h2>Inserire,un numero conpreso tra 1 e 100</h2> 

Quantità da acquistare :<input type='text' name= 1 purchase ' > 



i, 



<?php 
if (SpurErr) 

echo("<font color='red' size='2'> Valore non 
compreso nell 1 intervallo</font>" ) ; 

?> 



<br><br> 
<input type= 

</form> 



siihmit' i — 



imit'> 



i 

Se viene individuato un valore non compreso nell'intervallo, compare un messag- 
gio di errore, come quello della Figura 19-2. 



'3 http://localhost/phpbook/esempioI9-2.php - Mìci 
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<r» Indietro - 1 



I Cerca 



1 Preferiti (#Multimei 



Indirizzo é% http!//localhost/phpbook/esernpiol9-2,php 



Inserire un numero compreso tra 1 e 100 



Quantità da acquistare ) 



Valore non compreso nell'intervallo 



^Operazione completata 



. WÌ§. Intranet locale 



Figura 1 9.2 

Messaggio di errore riguardante la convalida dell'intervallo. 



Convalida delle stringhe 



Accade spesso di commende errori nella digitazione del testo, anche nella compila- 
zione di semplici moduli. I in;i soluzione consiste nel ridurre al minimo la quantità 
di testo che l'utente devi- digitale Poi i illenere questo risultato, si potrebbe fornire 
il maggior numero possibile ili \ lei modulo .11 ini verso menu di selezione, elimi- 
nando il problema alla rat In 1 l uti ivln non sempre è possibile ricorrere a questa 
soluzione. Lo seri pi clic ii.i ili h melodi pei ottenere e convalidare una 



stringa di input che rappresenta un mese dell'anno, Il me «.Itili i , , mtlene un menu di 
selezione da cui l'utente può scegliere un mese (il meli "I. i sciupili e), e un campo 
per l'immissione di testo in cui l'utente deve inserire la stringa del mese. È questo il 
campo che dobbiamo convalidare. 

<?php 

// Convalida dei moduli e conservazione dei dati - Esempio 19-3 

Smonths = array ( "Gennaio" , "Febbraio" , "Marzo" , "Aprile" , "Maggio" , "Giugno" , 
"Luglio" , "Agosto" , "Settembre" , "Ottobre" , "Novembre" , "Dicembre" ) ; 

t 

if(isset($_POST["submit"])){ 
$month = $_P0ST|"month"]; 
$monErr=-1 ; 
for($c=0;$c<12;$c++) 

if (!strncasecmp($months[$c] ,$_P0ST[ "month2" ] ,3) ) 
$monErr=$c; 
if($monErr != -1) 

echo("Hai selezionato $month e digitato " . $months[$monErr] ) ; 

olse 

$monErr=-1 ; 



?> 



<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method='post'> 

<h2>Selezionare il mese di nascita</h2> 
Mese <select name='month'> 

<option>Gennaio</option> 

<option>Febbraio</option> 

<option>Marzo</option> 

<option>Aprile</option> 

<option>Maggio</option> 

<option>Giugno</option> 

<option>Luglio</option> 

<option>Agosto</option> 

<option>Settembre</option> 

<option>Ottobre</option> 

<option>Novembre</option> 

<option>Dicembre</option> 

</select> 

<br> 

Mese <input type='text' name='month2'> 
<?php 

if ($monErr == -1 ) 

echo("<font color='red' size='2'> Mese non riconosciuto</font>" ) ; 

<br><b^> 

<input type='submit' name='submit'> 
</form> 



Lo script inizia dichiarando un il ITO) $months e lo popola con i mesi dell'anno. Suc- 
. cssivamente un'istruzione if coni rolla N il modulo è stato inviato: 

$months = array ( "Gennaio" , "Febbraio" , "Marzo" , "Aprile" , "Maggio" , "Giugno" . 

- I .... 1 .: - Il II * 1 Il U A - E • - .. I. . _ 4. u • ■ . _ _ . I .. _ . 



■Luglio" , "Agosto" , "Settembre" , "Ottobre" , "Novembre" , "Dicembre" ) ; 
lf ( isset ( $_POST [ " submit " ] ) ) { 



RUindi una variabile $monErr viene dichiarata e impostata a -1. Questa variabile 
servirà per memorizzare la posizione del mese nell'array, qualora venga trovato. Un 
Ciclo f or viene iterato 12 volte per mettere a confronto ciascun mese presente 
Bell'array con i dati inseriti nel modulo. A tal fine si utilizza la funzione strnease- 
emp ( ) , introdotta nel Capitolo 17, che confronta i primi tre caratteri dei dati immessi 
feon i primi tre dell'elemento dell'array corrente. La funzione non distingue tra mi- 
nuscole e maiuscole, quindi non ha alcuna importanza se l'utente ha digitato il 
nome del mese con un carattere maiuscolo o minuscolo. 

Se la funzione trova una corrispondenza, la variabile $monErr viene impostata al 
valore corrente del conteggio dell'array. Se dopo il confronto di tutti i dodici ele- 
menti nell'array si trova una corrispondenza, compare un messaggio: 

r sì, 

Smonth = $_P0ST[ "month" ] ; 
$monErr=-1 ; 
for($c=0;$c<12;$c++) 

if (!strncasecmp($months[$c],$_P0ST["month2"],3)) 
$monErr=$c; 
if($monErr != -1) 

echo("Hai selezionato Smonth e digitato " . $mon 

} 

else 

$monErr=-1 ; 

La parte successiva dello script visualizza il menu di selezione: 

I 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method='post'> 

<h2>Selezionare il mese di nascita</h2> 
Mese <select nanie= ' month 1 > 

<option>Gennaio</option> 

<option>Febbraio</option> 

<option>Marzo</option> 

<option>Aprile</option> 

<option>Maggio</option> 

<option>Giugno</option> 

<option>Luglio</option> 

<option>Agosto</option> 

<option>Settembre</option> 

<option>Ottobre</option> 

<option>Novembre</option> 

<option>Dicembre</option> 

</select> 

<br> 

Infine, se il (lag $monErr è sialo Impostato, viene visualizzato il campo testo del 
modulo insiemi- a un mrv,,i W u,n > .li errore 



Mese <input type-'toxr nano- 'no»' 
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<?php 

if($monErr == -1) 

echo("<font color='red' size='2'> Mose non rioom>IOiuto</font>" ) ; 

?> 

<br><br> 

<input type='submit' name=' submit '> 
</form> 

La Figura 19-3 illustra l'output relativo al messaggio d'errore dello script precedente. 



H http:/7localhost/phpbook,/esempiol9'3.php - Microsoft Internet 
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Selezionare il mese di nascita 




Mese 
Mese 



Gennaio 




i 



■ 



[il j Operazione completata 



Figura 193 

Errore di mese non riconosciuto. 




Conservazione dei dati 
nei campi testo e password 



Negli esempi di convalida dei moduli mostrati finora, qualunque dato inserito 
dall'utente nel modulo andava perduto quando il modulo veniva nuovamente vi- 
sualizzato insieme ai corrispondenti messaggi di errore. La scelta di non visualizzare 
nuovamente i dati considerati errati potrebbe costituire una buona soluzione, ma 
non inserire i campi che hanno superato il test di convalida è molto frustrante per 
l'utente, che si ritrova costretto a digitare di nuovo le informazioni; nella migliore 
delle ipotesi è una semplice seccatura, che però potrebbe portare l'utente a com- 
mettere nuovi errori nell'immissione dei dati. In questo caso, la soluzione migliore 
sarebbe visualizzare i dati inseriti in modo corretto nei campi del modulo quando 
quest'ultimo viene riproposto all'utente. 



v_umv<iiiu«i imi iiunimi u cullaci yatiuiie uci unii 



Lo script che segue mostra un esempio di rivisualizzazione dei dati del modulo 
all'Interno di un campo testo: 

<?php 

// Convalida dei moduli e conservazione dei dati - Esempio 19-4 
^MP^ 

if ( isset ( $_P0ST [ " submit " ] ) ) { 
Ssurname = $_P0ST[ "surname" ] ; 
Sfirstname = $_P0ST[ "f irstname" ] ; 

if (Sfirstname == "") 

$f irstErr = 1 ; 
else 

SfirstErr = 0; 
if (Ssurname == " " ) 

SsurErr = 1 ; 
else 

SsurErr = 0; 

else { 

SfirstErr = 0; 
SsurErr = 0; 
$su marne = ""; 
Sfirstname = ""; 

} 

?> 

<form action='<?php echo(S_SERVER[ "PHP_SELF" ] ) ?>' method= 1 post '> 

<h2>Inserire i dati personali:</h2> 
Nome: <input type='text' name= 'f irstname 1 
value= 1 <?php echo (Sfirstname) ?> 1 > 
<?php 

if (SfirstErr) 

echo("<font color='red' size='2'> Inserire il nome</font>" ) ; 

<br/> 

Cognome :<input type='text' name=' surname' 
value='<?php echo(Ssurname)?>'> 
<?php 
if (SsurErr) 

echo("<font cofjlor=' red ' size='2'> Inserire il cognome</font>" ) ; 

■ ' ' '■?>' 

<br /><br /> 

<input type=' submit 1 name=' submit '> 
</form> 

Lo script inizia controllarteli 1 M il moduli i c sialo inviato e, in caso affermativo, veri- 
fica se nei campi f irstnamo C lurnamo W mi i Stati inseriti dei dati: 

if( isset ($_P0ST[" submit* ))){ 



Ssurname = $_POST| "surname" ] ; 
$firstname = S_POST[ "firstname" ] ; 

if ($firstname == "") 
SfirstErr = 1; 

else 

$firstErr = 0; 
if ($surname == "") 
$surErr = 1 ; 

else 

$surErr = 0; 

} 

else { 

$firstErr = 0; 
SsurErr = 0; 
Ssurname = " " ; 
$f irstname = " " ; 

La pane successiva dello script visualizza l'inizio del modulo: 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method= , post 1 > 

<h2>Inserire i dati personali:</h2> 

Di seguito è riportata quella parte "intelligente" del codice che permette di conser- 
vare i dati contenuti nel modulo. Osservate che i campi di testo firstname e sur- 
name hanno un attributo value. Osservate inoltre lo script PHP che è stato aggiunto 
per riprodurre il valore delle variabili $f irstname e $surname nell'attributo value. 
In questo modo è certo che i valori contenuti in queste variabili compariranno nel 
campo di testo quando il modulo sarà visualizzato, conservando così i dati: 

Nome: <input type='text' name=' firstname 1 
value= 1 <?php echo($f irstname) ?> 1 > 
<?php 

if (SfirstErr) 

echo("<font color='red 1 size='2"> Inserire il nome</font>" ) ; 

?> 

<br/> 

Cognome :<input type='text' name= 1 surname 
value='<?php echo($surname)?>'> 
<?php 
if (SsurErr) 

echo("<font co^lor='red' size='2'> Inserire il cognome</font>" ) ; 
<br /><br /> 

<input type='submit' name='submit'> 
</form> 



La Figura 19.4 mostra un modulo inviato. Mentre il nome è sialo inserito, il cogno- 
me manca, e ciò comporta la visualizzazione di un messaggio di errore, Osservate 
che il dato firstname compare nuovamente nel modulo. 



Convalid 
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^Indietro - * V @ Sì ^Cerca fjjj Preferiti ^Multimedia \j [ i§>r # 



dirizzo ^)http:j/localhostjpripbookyesempiol9-4.php 



3* 



Vai 



Collegamenti 



Inserire i dati personali: 







(simon 


— ,i — — 



Cognome: | 



| Operazione completata 



Figura 1 9.4 

Conservazione dei dati in un campo di testo. 



Conservazione dei dati nei campi textarea 



La conservazione dei dati inseriti in un campo textarea è facile. Considerate lo script 



seguente: 
<?php 



// Convalida dei moduli e conservazione dei dati - Esempio 19-5 



if (isset($_POST["submit" ] ) ){ 

Saddress = $_P0ST[ "address" ] ; 
if (Saddress == "") 

SaddressErr = 1 ; 



else 



SaddressErr = 0; 



} 

else { 

SaddressErr = 1 ; 
Saddress = " " ; 



<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method='post '> 

<h2>Inserire i dati personali :</h2> 
Indirizzo: <textarea name-'addrMs' rows='5'> 

<?php echo($addr«n) ?> 

</textarea> 
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<?php 

if (SaddressErr) 
eoho("<font color='red' size='2'> Instr.no un 
indirizzo</font>"); 

?> 

<br><br> 

<input type='submit' name= 1 submit ' > 
</form> 

Lo script inizia controllando se il modulo è stato inviato e, in caso affermativo, veri- 
fica se la variabile $address contiene qualche dato: 

if ( isset ( $_P0ST [" submit "]) K 

$address = $_P0ST[ "address" ] ; 
if($address == "") 

SaddressErr = 1; 

else 

SaddressErr = 0; 

else { 

$addressErr = 1; 
$address = ■■; 

?> <-, ; • 1 1 

La parte successiva dello script visualizza il modulo: 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method= 1 post 1 > 

<h2>Inserire i dati personali:</h2> 

Per conservare i dati immessi nel campo modulo area di testo, il valore della varia- 
bile $address viene visualizzato fra i tag iniziale e finale dell'elemento textarea: 

Indirizzo: <textarea name=' address ' rows='5'> 
<?php echo($address) ?> 
■ </textarea> 
<?php 

if (SaddressErr) 
echo("<font color= , red' size='2'> Inserire un 
indirizzo</font>"); 

■ 1> ' 

<br><br> 

<input type=' submit' name=' submit '> 
</form> 



L'output ottenuto dallo script precedente è quello della Figura 19.5. 
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Indirizzo |^) http://localhost/phpbook/esempiol9-5,ph 


3 


^ '^ Va L 





Inserire i dati personali: 



— 



Indirizzo: 




Via Forca, ili |1 
Milano 
Italia 



- 



Figura 19.5 

Conservazione dei dati nel campo textarea. 





Conservazione dei dati nei campi 
casella di controllo e pulsante di opzione 

r 

Gli elementi casella di controllo e pulsante di opzione possono conservare le pro- 
prie selezioni più o meno come i campi testo e password. Lo script che segue illu- 
sila come viene mantenuta la selezione effettuata dall'utente: 

<?php r, 

// Convalida dei moduli e conservazione dei dati - Esempio 19-6 



if ( isset ( $_P0ST[ 11 submit " ] ) ) { 
$mus = $_P0ST["mus"]; 
if ($mus == " " ) 

SmusErr = 1 ; 
else 

SmusErr = 0: 

} 

else { 

SmusErr = 1 ; 
$mus = 

} 



?> 
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<form action='<?php echo($_SERVER[ " PHP_SELF" 1 ) ?>' Mtlwd-'POI*'» 
<h2>Selezionare il genere musicale preferito: </h2> 

rl ,„i <inòut type=' radio' narae^mus' value=" classica 
.Classica WtW^ == , classical) e cho( 'checked' ) ; ?» 

<?php 

Ìf Sor5ont color='red' size='2'> Selezionare il genere 
musicale pref erito</font>" ) ; 

<br><br> 

<input type= , submit l name='submit > 



</form> 
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Indirizzo idi http://localhost/phpbookJesemplol9-6.php 



Selezionare il genere musicale preferito: 



Pop 0 Rock G Classica <? 



Operazione completata 




Figura 19.6 

Conservazione del pulsante di opzione selezionato. 
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Conservazione dei dati 
nel campo menu di selezione 

Anche i menu di selezione possono m;micnere le proprie selezioni. Considerate le 
BCrìpt seguente: 

<?php 

// Convalida dei moduli e conservazione dei dati - Esempio 19-7 



if ( isset ( $_P0ST[ " submit " ] ) ){ 
Stitle = $_P0ST["title"]; 
lf($title == "Selezionare...") 

StitErr = 1; 
else 

StitErr = 0; 



olse { 

StitErr = 1; 

> 

?> 



Stitle = ""; 



<body> 

<html> 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>• method='post'> 

<h2>Inserire i dati personali:</h2> 
Titolo: <select name='title'> 

u" 

<option>Selezionare. . .</option> 

<option <?php if (Stitle == "Sig.") echo( "Selected" )?» 
Sig.</option> 

<option <?php if (Stitle == "Sig.ra") echo( "Selected" )?» 

Sig.ra</option> 
<option <?php if($title == "Dr.") echo( "Selected" ) ?» 
Dr.</option> 

<option <?php if (Stitle == "Ing.") echo( "Selected" ) ?» 
Ing.</option> 

<option <?php if (Stitle == "Prof.") echo( "Selected" ) ?» 
Prof .</option> 

</select> 
<?php 
if (StitErr) 

echo("<font color='red' size='2'> Selezionare un 
titolo</font>"); 

<br><br> 

<input type=' submit' name=' submit '> 

</form> 
</body> 
</html> 
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Lo script visualizza le opzioni relative alle selezioni del numi e controlla se >' valore 
della variabile $title, che memorizza il valore dell'opzioni' selezionata, è uguale 
all'opzione corrente. In caso affermativo, l'attributo "selected" viene prodotto come 
parte dell'elemento option. La Figura 19-7 illustra che l'opzione "Sig." del menu di 
selezione inviato è stata mantenuta. 



1 li httD:,'7localhost/phpbook/esempiol 9-7.php - Microsoft Internet Explorer 


j | |j 
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Inserire i dati personali: 






Titolo: Sig. !É 

1 ===== 




": ': . 


li] Operazione completata ì ! g Intranet locale 





Figura 19.7 

Conservazione di un'opzione scelta tra gli elementi di selezione. 



Dati nascosti 

I moduli possono essere utilizzati per passare dati ogni volta che un modulo viene 
visualizzato, senza che l'utente possa tuttavia vederli. A tal fine è possibile utilizzare 
l'elemento del modulo hidden. 

Questa possibilità può rivelarsi utile per passare informazioni da uno script all'altro 
o restituire dati allo stesso script mediante un modulo, senza che l'utente veda i dati 
e possa interferire. 

<?php 

// convalida dei moduli e conservazione dei dati - Esempio 19-8 

// 



if ( isset ($_P0ST [ " submit " ] ) ) { 

Scount = $_P0ST["count"]; 
$count++; 

else 

$count = 1 ; 



?> 
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<h2>Questo modulo è stato inviato <?php echo($count) ?> volte</h2> 
<lnput type='hidden' name=' count ' value='<?php echo($count) ?>'> 
'Input type=' submit ' name=' submit '> 



</form> 



1 1 1 script è molto semplice: inizia controllando se il modulo è stato inviato e, in caso 
Affermativo, incrementa il valore della variabile $count. Se il modulo non è stato in- 



vialo, il valore della variabile Scount è ini] 




1 1 ( isset ($_P0ST[ " submit "])) { 
Scount = $_P0ST[ "count"] ; 
$count++; 

else 

Scount = 1 ; 

?> 

j» Parte successiva dello script visualizza il modulo e un titolo, che mostra il valore 
Bella variabile $count: 

«forni action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method=' post "> 

<h2>Questo modulo è stato inviato <?php echo(Scount) ?> volte</h2> 

Nascosto nel modulo c'è un nuovo tipo di elemento, noto con il nome di hidden. 
< ili elementi di tipo hidden possono accettare molti attributi utilizzati anche dagli 
tini elementi, come name e value. 

In questo caso il nome dell'elemento è count (il nome della variabile), mentre il va- 
fcre e' il valore corrente della variabile $count: 

input type=' hidden 1 name=' count 1 value='<?php echo (Scount) ?>'.> 
«Input type=' submit 1 name=' submit '> 

In pratica, quando l'utente fa clic sul pulsante di invio, il valore di $count viene 
I tassato di nuovo allo script (anche se l'utente non si accorge di nulla), viene incre- 
itwnmrr. p vkiiali773fr> Hi nnnvn t 'output ottenuto da questo script è quello della 



n ir muto e visualizzato 
Figura 19.8. 



</form> 



Array e moduli 



i un ira, in questo capitolo, si è visto come i dati dei moduli possano essere conser- 
vali e/o nascosti all'interno del modulo. Un aspetto che non è stato analizzato è il 
^Assaggio degli array attraverso I un ululi. Una delle ragioni di questa omissione è 
• He gli array devono esseri- minali in modo leggermente diverso rispetto alle altre 
friabili. Potreste pensare die <• p. ».. ludere un array in un modulo sotto for- 
ma di dato nascosto; luii.ivi.i h mirrino più avanti, ciò non è possibile. Lo 
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3 tp://localhost/phpbook /esempio 19-8.php - Microsoft; 



-iDlxl 



Modifica Visualizza Preferiti Strumenti ? 



tro ' * @ [?| tSJ 1 S&Cerca ^Preferiti Multimedia J =Ì 



| http:y/localhost/phpbookyesempiol9-8.php 



•*| ^Vai | Collegamenti 



Questo modulo è stato inviato 4 volte 





Figura 19.8 

I dati r 

script che segue verifica se il modulo è stato inviato-, in caso affermativo, compare il 
conte 

<?php 

// Convalida dei moduli e conservazione dei dati - Esempio 19-9 

// 

if ( isset ( $_POST [ " submit " ] ) ) { 

echo("L'array contiene:<br>" ) ; 
Snames = $_P0ST[ ' names ' ] ; 
for(Sa=0;$a<4;$a++) 

echo($names[$a] . "<br>"); 

} 

else 

ies = array( "Simon" , "Liz" , "Gemma" , "Hayley") ; 



?> 



<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method= 1 post ' > 

<h2>Questo modulo contiene un array nascosto. </h2> 

<input type='hidden' name='names' value='<?php echo(Snames) ?>'> 

<input type=' submit' name= ' submit '> 

</form> 

Viene utilizzato un ciclo for per visualizzare il contenni.) dell'arra) 

if(isset($_POST[-submit"l)){ 
echo("L' array contiene : <br>" ) ; 
Snames = $_P0ST| names' ) ; 
for($a-8;Sa<4;$a**) 



con» 



> 



echo($names[$a] . "<br>"); 



Se il modulo non è stato ancora inviato, l'array viene creato per la prima volta: 



else 



Snames = array ( "Simon" , "Liz" , "Gemma" , "Hayley" ) ; 

■ 

Il modulo viene visualizzato e, come spiegato in precedenza, viene incluso un ele- 
mento hidden per contenere i valori dell'array names: 

<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method= ' post 1 > 
<h2>Questo modulo contiene un array nascosto. </h2> 



<input type='hidden' name= ' names ' value='<?php echo(Snames) ?>'> 
<input type=' submit' name= ' submit ' > 



I </f 



orm> 



Funziona tutto molto bene fino a quando non si decide di inviare il modulo e si ot- 
tiene l'output della Figura 19.9. Che cosa è accaduto ai dati dell'array? Sfortunata- 
mente non è possibile passare gli array tra i moduli con questa procedura, e pertan- 
to i dati sono andati perduti. 



3 http://localhost/phpbook/esempìol9-9.php - Microsoft Internet 



File Modifica Visualizza Preferiti Strumenti ? 
si-" Indietro » 



<Ù \È tffl ! ^Cerca 



Indirizzo ujgQ http://localhost/phpbooKfesernpiol9-9. 



========== 




— 



L'array contiene: 
A 




Questo modulo contiene un array nascosto. 



Invi 



azione 



Figura 19.9 

Passaggio errato di un array. 



■ Intranet locale 



( hvianicnie esiste >n ri. ..li . li. |H iniclt.)ii(i di risolvere il problema. 

Come i erto ricorderete un .mn . un i ■.r.|iirii/.i nulu i//.ua di variabili Se divides- 
simo l'array in pam. v in il .uilmt) ugni elemento dell'array come una variabile 
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separata, potremmo passare »ll urray attraverso .1 modul. . i ...,.„ I -m ... , le modulo 
sarà necessario rlcombinar* I datì, rna il contenuto deltoy wl majtt ma 

Considerate lo script se K ..enu-. c he è una versione mod.lt. a.., d, « u ^ e ^"J v 
La prima parte «minili» « he il modulo sia stato inviato; m easo al e mattvo, lamy 
names viene ereato partendo dalle variabili separate che saranno costruite più avanti. 

<?php 

// convalida dei moduli e conservazione dei dati - Esempio 19-10 



if(isset($_POST ["submit" ])){ 

echo("L'array contiene : <br>" ) ; , 

Snames = array($_POST[ • name0' ] ,S_POST[ namel 1,$_P0ST[ name2 

$_P0ST['name3']) ; 
for($a=0;$a<4;$a++) 

echo($names[$a] . "<br>"); 

} 

6186 $nan,es = array ("Simon" , »Liz" , "Gemma" , "Hayley» ) ; 
?> 

<form action='<?php echo($_SERVER[ »PHP_SELF" ] ) ?>,' method=' post '> 

<h2>Questo modulo contiene un array nascosto. </h2> 
<?php 

' "ecTo r Snjuf;;^ ì hidden | name= ' nameSa ; value= ' " , $namesl$a] .■■>"); 
<input type=' submit' name= ' submit 1 > 
</form> 

Viene utilizzato un ciclo f or per visualizzare il contenuto dell'array: 

i -v » 
if (isset($_POST["submit" ] ) ){ 

i *mtmm ■ i • ' • 

$_P0ST['name3'l); 

} 

$names = array ( "Simon" , "Liz" , "Gemma" , "Hayley" ) ; 

?> 

Come nell'esempio precedente, la parte successiva dello script visualizza il modulo: 
<form action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method= ' post ' > 



<h2>Questo modulo contiene un array nascosto. </h2> 



Convalida dei moduli e conservazione dei dati 



La parte seguente dello script utilizza un ciclo f or per visualizzare i valori dell'array 
come elementi di modulo nascosto. Osservate che a ciascun elemento è assegnato 



un nome diverso, partendo da name0, namel e così via: 



<?php 

for($a=0;$a<4;$a++) 

echo("<input type=' hidden 1 name='na 

?> 

<input type='submit' name='submit'> 

- 

</f orm> 



i' value=' ", $names[$a] . 11 '>"); 



</form> 

L esempio precedente funziona, ma esiste un altra procedura che consente di otte- 
nere il medesimo risultato in modo più elegante. Considerate lo script seguente che: 
esegue le stesse operazioni con una tecnica diversa: 

■.. 

<?php 

// Convalida dei moduli e conservazione dei dati - Esempio 19-11 
// 

■ 

lf(isset($_POST["submit"])){ 
echo("L' array contiene :<br>" ) ; 
$name = $_P0ST[ "rame 1 ] ; 
Snames = explode( 11 j " ,$name) ; 
for($a=0;$a<4;$a++) 

echo($names[$a] . "<br>"); 

else { 

Snames = array ( "Simon" , "Liz" , "Gemma" , "Hayley" ) ; 
Sname = implode ( " J " , Snames) ; 

E? .- 



?> 



<form action='< ?P hp echo($_SERVER[ "PHP.SELF" ] ) ?>< 

<h2>Questo modulo contiene un array nascosto. </h2> 
<?php 

echo("<input type='hidden 1 name='name' value=' Sname '>") ; 

?> 

<input type='submit' name=' submit '> 



</form> 



... 



Lo script controlla che il modulo sia stato inviato e, in tal caso, utilizza la funzione 
explode() (introdotta nel Capitolo 16) per estrarre un'unica stringa con i nomi separa- 
ti da caratteri "j" e inserirla in un array, che sarà poi visualizzato con un ciclo for: 



if (isset($_POST[ "submit | ) i ( 
echo("L'array cont tono : -i» • ' }| 
Sname = $_P0ST[ 'nnm« | , 
Snames - exploda( " | • ,tni 
for (Si-0;$a<4 ;••++) 
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echo($names|$a] . "<br>"); 

} »«t*éì. 

Se il modulo non è stato inviato, viene creato l'array e viene chiamata la funzione 
implode ( ) per costruire un'unica stringa con il contenuto dell'array, separato con il 

! 



carattere " 1 



elS $names = array( "Simon" ] »Liz" , "Gemma" , "Hayley" ) ; 
$name = implode ( " | " ,$names) ; 

} 

?> 

11 modulo viene visualizzato come prima: 

<form action='<?php echo(S_SERVER[ »PHP_SELF" ] ) ?>' method=' post 1 > 

; 

<h2>uuesto modulo contiene un array nascosto. </h2> 

Invece di dover visualizzare diverse variabili nascoste, è sufficiente includere l'unica 
stringa implosa: 

<?P e?ho("<in P Lit type='hidden' na m e='name' value='$nan,e'>» ) ; 
<input type='submit' name='submit'> 
</f orm> 



La Figura 19-10 mostra l'output dei due script precedenti. 



t| http:/7localhost/phpbook/esempiol9-10.php - Micr 
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Figura 19.10 

Il modo corretto di passare un array, 



convalida dn moduli e conservazione dei dati 
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Riepilogo 

Questo capitolo ha mostrato come convalidare i dati dei moduli e ha messo in luce 
l'importanza di questa operazione per l'interazione con l'utente. Si è visto come sia 
possibile conservare i dati inseriti correttamente nei moduli nel caso in cui questi 
debbano essere riproposti agli utenti, eliminando l'onere di inserire di nuovo il testo 
e selezionare i dati quando non è richiesto. Nel prossimo capitolo verranno analiz- 
zili alcuni aspetti della protezione legati all'utilizzo dei moduli, prendendo in consi- 
derazione i potenziali rischi che ne possono derivare. 




Capitolo 20 

Problemi di sicurezza 



Introduzione 



Molte applicazioni Web utilizzano metodi di autenticazione o accesso comuni che 
consentono e impediscono l'accesso a determinati utenti. Tuttavia, il semplice im- 
piego di una password per accedere a un sistema non è l'unico modo per rendere 
sicuro un sistema di tipo Web. Occorre infatti utilizzare anche metodi di cifratura 
per memorizzare le password all'interno di database o file di testo; inoltre è possibi- 
le verificare le pagine referenti per fare in modo che i dati che vengano passati a 
una pagina Web provengano effettivamente da un'origine prevista e non da fonte 
lunota. Questo capitolo illustra come rendere più sicuri i propri sistemi Web online. 
H 



Metodi di cifratura 



La cifratura aumenta la sicurezza di tutti i sistemi di rete, poiché è in grado di offrire la 
ragionevole sicurezza che nessuno sarà in grado di sottrarre una password e accedere 
al sistema in modo non autorizzato. PHP supporta due metodi di cifratura utilizzati 
comunemente per la cifratura dei dati: MD5 e CRYPT. Tali metodi sono supportati at- 
traverso le due funzioni md5 ( ) e crypt ( ) , e la loro sintassi è la seguente. 



Btring md5 (string parola ); 
string crypt (string parola 



string opzione) ; 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 



Tipo Descrizione 



parola 
opzione 



Resi il u zie ino .li 
md5()/crypt() 



string 
string 



■trino 



Stringa da cifrare. 

CRYPT_STD_DES. Cifratura DES standard con un sale di 
due caratteri, 

CRYPT_EXT_DES. Cifratura DES estesa con un sale di no- 
\r ainiltcri. 

Clivi" I Ml)5 ( alialura MDS con un sale di dodici caratte- 
ri • lo- [nixlfl xin $1$. 

CHVI'T 0L0WFI8H, Cifratura Blowflsh con un sale di se- 
■ li. i ■ ...hi. n . he Inizi» con $2$. 
i. ili iii.i 
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Esempi di l'unzioni: 

Sencrypt = md5($text) ; 

$encrypt2 = crypt($text, CRYPT_STD_DES) ; 

Lo script dell'esempio seguente illustra l'utilizzo di queste funzioni. 

<?php 

// Problemi di sicurezza - Esempio 20-1 

// 

define ("TEST", "test"); 

Sencrypt = md5(TEST) ; 

$encrypt2 = crypt(TEST, CRYPT_STD_DES ) ; 

echo ■$en C rypt<p>$er,ory Pt 2- i 

■ 

L'output del testo "test" dopo la cifratura è il seguente. 

MD5 : 098f 6bCd4621 d373cade4e832627b4f 6 
Crypt: 1$MDgPcadkr82 

MD5 è il metodo di cifratura più veloce e più comune. La stringa cifrata è lunga 32 
caratteri e non può essere decifrata facilmente. Quando si utilizza CRYPT, la stringi! 
cifrata prodotta è casuale e non può essere sfruttata agevolmente per i metodi di au- 
tenticazione Web. 



ccesso e autenticazione 

L'impiego di moduli sicuri assieme a password cifrate garantisce che gli script offrano 
la massima sicurezza e consentano l'accesso solo a coloro che dispongono dell'auto- 
rizzazione di accesso a questi sistemi. Esistono due tipi di autenticazione: il modulo di 
accesso semplice e l'autenticazione HTTP. Il secondo metodo utilizza il modulo di au- 
tenticazione di Apache ed è più sicuro e molto difficile da violare. Le password, devo- 
no essere cifrate e memorizzate in forma cifrata; in tal caso, anche se qualcuno legges- 
se il file delle password, gli sarebbe impossibile utilizzarle in quanto non decifrabili. 

Sistema di accesso a modulo semplice che utilizza 
un file delle password con un singolo utente 

Lo script che segue illustra la verifica delle password utilizzando il nome utente 
"john" e la password cifrata "test'': 

<?php 

// Problemi di sicurezza - Esempio 20-2 

// IMil i 





if (isset($_POST["submit"])) { 

Suserpass = array(" john" , "098f 6bcd462ld373cade4e832627b4f6" ) ; 

if (($_POST["username"] == "$userpass[0] " ) AND 
(md5($_P0ST[ "password"] ) == Suserpass [1 ] ) ) 

■ { 

echo "Accesso riuscito!"; 



rttml> 

<body bgcolor="#FFFFFF" text="#000000"> 

<form name=" formi" method="post" action=""> 



Nome utente :<input type="text" name="username"> 
<br> 

Password :<input type="password" name=" password "> 
<br> 

<input type="submit" name="submit" value= "Accedi "> 
<input type=" reset" name="Submit2» value="Reimposta"> 



</form> 
</body> 
</html> 

Lo script verifica se il modulo è stato inviato: 



if (isset($_POST["submit"l)) { 

In tal caso l'array delle password viene inizializzato: 

Suserpass = array("john", "098f 6bcd4621d373cade4e832627b4f6" ) ; 

Se il nome utente e la password conispondono, viene visualizzato un messaggio di 
conferma: 

if(($_POST["username"] == "Suserpass [0] " ) AND 
(md5($_P0ST[ "password"]) == $userpass[1 1 ) ) 

echo "Accesso riuscito!"; 
IK ' 

La parte finale dello script crea il modulo per l'utente: 
<html> 

<body bgcolor="#FFFFFF" text="#000000"> 

<form name="form1" mothod="post" action=""> 

Nome utente:<lnput typo»"ttxt" name="username"> 
<br> 

Password: «input typ» ' "password"> 

<br> 

<input type--5uhmn 1 lUtMlt" vnluo-"Accedi"> 

<input typ8-"r«Mt* MM-*tuftBlll' va»uo--Rolmposta"> 



</form> 
</body> 
</html> 

Autenticazione HTTP sicura con Apache 

Quando si utilizza un server Apache, è possibile applicare un'altra forma di autenti- 
cazione che sfrutta la funzione header ( ) per inviare un'intestazione HTTP al brow- 
ser. 

La sintassi della funzione è la seguente. 

1 

void header (string httpHeader) ; 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


httpHeader 
Restituzione di header () 


string 
void 


Intestazione HTTP. 
Non restituisce alcunché. 


Esempio di funzione: 







header ("WWW-Authenticate: Basic realm=\"Secure LoginV 1 "); 
Lo script seguente illustra un esempio di utilizzo di questa funzione: 
<?php 

// Problemi di sicurezza - Esempio 20-3 

m - - - 

$userpass = array( " john" , "098f6bcd4621d373cade4e832627b4f6" ) ; 

if ( ( isset ( $_SERVER [ " PHP_AUTH_USER " ] ) ) OR ( empty ( $_SERVER [ " PHP_AUTH_PW" ] ) ) 
OR ($_SERVER["PHP_AUTH_USER"] != $userpass[0] ) 
OR (md5($_SERVER["PHP_AUTH_PW"]) != $userpass[1 ] ) ) { 

Header ("WlAW-Authenticate: Basic realm=\ "Secure Login\""); 
Header( "HTTP/1 .0 401 Unauthorized" ) ; 
echo"Accesso fallito. Riprovare"; 

else 

echo "Accesso riuscito»; 

?> 

Questo esempio impiega il metodo di autenticazione HTTP per proteggere qualun- 
que accesso al sistema. Viene utilizzata la funzione header ( ) per inviare un mes- 
saggio "Authentication Required" al browser del client e fare così in modo che ven- 
ga visualizzata una finestra per l'immissione di nome utente e password. Quando 
l'utente ha inserito un nome utente e una password, l'URL contenente lo script PHP 
verrà richiamato con le variabili predefinite PHP_AUTH_USER e PHP_AUTH_PW, che 
contengono il nome utente e la password forniti. La finestra a comparsa che viene 
generata è quella della Figura 20.1. 




Figura 20.1 

Tipo di autorizzazione HTTP standard. 

Verifica delle pagine referenti 



Quando si sviluppa uno script di registrazione, è necessario adottare la massima si- 
curezza per proteggere il sistema da registrazioni indesiderate, di massa o automati- 
che, che potrebbero danneggiare il sistema e il database in cui vengono conservati 
tutti i nomi utente e le password. La creazione di uno script in grado di generare, 
per esempio, 100.000 nomi utente casuali per "inondare" l'applicazione con tentati- 
vi di accesso è molto semplice. 

Immaginate per esempio di avere un modulo Web per la registrazione in linea. 
Questo modulo è costituito da due caselle di testo (una per il nome utente e l'altra 
per la password) e da un pulsante per l'invio dei dati. Supponete che la prima casel- 
la di testo si chiami "user", che la seconda si chiami "pass" e che il nome del pulsan- 
te di invio sia "submit". Quando viene impartita un'istruzione HTTP Post (quando si 
preme il pulsante Invia) queste tré variabili ($user, $pass, $submit) vengono pas- 
sate allo script, che registra l'utente 

O meglio, questo è ciò che dovrebbe accedere. Ma che cosa accade se qualcuno (su 
un altro sito) crea uno si rlpt Web che passa l« medesime tre variabili al vostro script 
di registrazione? Che i < isa ai i u l< ••• h i * rlpl \ lene eseguito un milione di volte? Po- 
trebbe consentire a qu.il. mi" di mu. -lu.-.i urli applicazione attraverso nomi utente 

e password generati ai ill< imi nu i ' «'In/Jone consiste nel garantire che lo 

script verifichi il "rcterenic (Idia pft||lni w il nome della pagina Web dello 



script che ha passalo i dati al vostro script. Se non <• il n< ■ . In- vi ..-.pettate, potete 

ignorare i dati. 

Considerate l'esempio seguente: 
<?php 

// Problemi di sicurezza - Esempio 20-4 

if (iSSet($_SERVER[ "HTTP_REFERER" ] ) ) { 

if ($_SERVER["HTTP_REFERER"1 == " http : / / localhost/phpbook/ 



esempio20-4.php") 

{ 



} 

} 



if ($_POST["submit"]) 

echo "Registrazione riuscita"; 
else 

echo "Pagina di riferimento errata. Registrazione fallita"; 



|fe.v... 1 ' : "•'.•"'*'•.-•'••' • 

<ht <body bgcolor= " #FFFFFF " text=" #000000 11 > 

<form name="form1" method="posf action=""> 

■ 



Nome utente:<input type="text" name="user"> 
<br> 

Password :<input type="text" name="pass"> 

San: <in P ut ty P e=»text" name=»email"> 

<br> 

<br> 

<input type="submit" name="submit" value="Registra"> 
<input type="reset" name="Submit2" value="Reimposta"> 

</form> 
</body> 
</html> 

In questo caso la pagina referente è http: / /localhost/phpbook/esempio20- 
4 . php. Nel vostro caso dovrete modificare l'informazione in relazione al nome e al 
percorso in cui sono memorizzati gli script sul vostro server. Lo script viene diviso 
in due parti principali: la prima verifica la pagina referente, la seconda visualizza il 
modulo che l'utente normalmente completerebbe per "registrarsi" con l'applicazio- 
ne. La Figura 20.2 illustra l'output prodotto dallo script precedente. 

Reindirizzamento dell'utente 

In molti casi (spesso per ragioni di sicurezza) potreste voler Indirizzare automatica- 
mente l'iitente a una nuova pagina Web per Impedirgli di Ci intimità) B utilizzare la 
pagina corrente. Questo è possibile con la funzione h*td«P() introdotta in prece- 
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| http: //localhost/phpbook/esempio20-4 . php 



Registrazione riuscita 
Nome utente: I 



Password: 



Email:| 



:straj Reimposta 




Figura 20.2 

Pagina referente corretta. 



denza nel capitolo, ma che ora utilizza la stringa Location : come in questo esem- 
pio: 

header ("Location: esempio20-5.php" ) ; 

Per vedere un esempio di questo meccanismo, create innanzi rutto lo script seguente: 



<?php 



Problemi di sicurezza - Esempio 20-5 
t 



echo "Questa è una pagina diversa"; 
?> 

Poi create questo ulteriore script, che è una modifica di e; 
<?php 

// Problemi di sicurezza - Esempio 20-6 

m, 




if(isset($_POST["submit"])> { 

$userpass = array ( " John" , -09Bf6bcd4621d373cade4e832627b4f6" ) ; 

if (($_POST["usernom» , l •• *luiorpaiilO] " ) AND 
(md5($_POST["pa»iword*n •uiorpots[ 1 ] ) ) 

I mi 

echo "Accesso rlu»oltol*l 

} 



header( "Location: esempio20-5.php" ) ; 

} 

} 

?> 

<html> ' 
<body bgcolor="#FFFFFF" text=" #000000 ■> 

<form name="forin1" raethod="post" action=""> 

Nome utente:<input type="text" name="user"> 
<br> 

Password :<input type="text" name="pass"> 
<br> 

<input type="submit° name="submit" value="Registra"> 
<input type="reset" name="Siibmit2" value="Reimposta"> 

^ </fprra> 

L'unica differenza tra quest'ultimo script e quello dell'esempio precedente è che 
ora, nel caso in cui la password e il nome utente non corrispondano, l'utente viene 
reindirizzato alla pagina esempio20-5.php. 

Riepilogo 

Questo capitolo ha introdotto il concetto di protezione delle applicazioni Web me- 
diante sistemi di accesso e registrazione. Sono stati illustrati anche i metodi più co- 
muni per cifrare stringhe e password, analizzando come possono essere implemen- 
tate per la protezione degli script di autenticazione. Infine è stata introdotta la solu- 
zione della "verifica della pagina referente" per impedire che abbiano luogo regi- 
strazioni indesiderate o automatizzate. Nel prossimo capitolo si vedrà come inviare 
messaggi di posta elettronica agli utenti e come creare messaggi e-mail di solo testo 
o HTML. 



Capitolo 21 

Invio di messaggi 



di posta elettronica 



Introduzione 



I messaggi di posta elettronica sono diventati uno strumento chiave della comunica- 
zione elettronica. PHP include alcune funzioni per la creazione di messaggi e-mail e 
per favorire l'interattività con essi. In questo capitolo introdurremo la funzione 
mail{ ), ampiamente utilizzata negli script PHP per inviare messaggi in formato te- 
sto semplice, HTML e MIME a uno o più destinatari contemporaneamente. Oltre a 
Illustrare questa funzione nella sua forma di base, analizzeremo alcune funzionalità 
più avanzate di mail( ), tra le quali gli strumenti che consentono di definire intesta- 
zioni aggiuntive, modificare il tipo di messaggio inviato, definire gli indirizzi di ri- 
posta e altri attributi utili. 



Funzione mailQ 



1,'invio di messaggi di posta elettronica con PHP è un'operazione molto semplice. A 
lai fine si utilizza la funzione mail ( ) , con la quale è possibile trasmettere il messaggio 
ila un server di posta di origine a uno specifico account di posta elettronica, sullo 
Messo server di posta o su uno diverso. Per utilizzare correttamente questa funzione, 
è necessario avere accesso a un server di posta. Il client di posta da utilizzare è defi- 
nito nel file php.ini. Di default, la sezione del file php.ini appropriata è la seguente: 



|mail function] 
; For Win32 only. 

SMTP = localhost ; for Win32 only 



; For Win32 only. 

dmail_from = rae@localh08t.com ; for Win32 only 

i For Unix only. You rany «upply nrQiimonts as well 

(default: "sondimi 11 i I | 
; sendmail_path = 



I .'ambiano in cui viono om'KWIIii il 'HI', UNIX <> Windows, dipendo d:i conio vie- 
ilo configuralo que.Mo l'ilo l' i molili' WIihIowm dovolo configurare l'ubicazione del 



zzo capitolo zi 



server di posta SMTP e l'indirizzo di posta elettronica. Gli Utenti I INDC devono inserire 
l'ubicazione della loro applicazione sendmail, che eli default, è Aisr/bin/sendmail. 
La sintassi della funzione è la seguente. 

■ V' ■". O' . ; . . .. , ■ 

bool mail (string destinatario, string oggetto, stnng messaggio, 
string intestazioni); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


destinatario 


string 


Destinatario del messaggio. 


oggetto 


string 


Oggetto del messaggio. 


messaggio 


string 


Il corpo del messaggio. 


intestazioni 


string 


Intestazioni aggiuntive del messaggio. 


Restituzione di mail() 


boolean 


TRUE se il messaggio di posta elettronica è stato ac- 






cettato per la consegna, FALSE in caso contrario. 



Esempio di funzione: 



mail ("qualcuno@esempio.com", "Oggetto", "Riga Uri Riga 2\n Riga 3"); 

La funzione mail( ) è composta da quattro attributi. Il primo serve per specificare 
l'account di posta di destinazione al quale inviare il messaggio. Il secondo è il testo 
che compare nella riga dell'oggetto del messaggio. Il terzo è il testo che costituisce 
il corpo del messaggio. Infine, il quarto attributo può essere utilizzato per specifica- 
re parametri e intestazioni supplementari. Nel prosieguo del libro si vedrà come uti- 
lizzare questi attributi, mentre ora imparerete come inviare un semplice messaggio 
di posta elettronica. 

Invio di un messaggio di posta elettronica 

È possibile utilizzare questo semplice formato della funzione mail( ) per inviare un 
breve messaggio di solo testo a un account di posta elettronica. L'account di posta 
elettronica utilizzato nell'esempio è il seguente: barbaramega@tiscali.it. Que- 
sto esempio non utilizza il quarto attributo della funzione mail( ) : 

<?php 

//Posta elettronica - Esempio 21-1 

fi • ' _ ; 

mailCbarbaramega@tiscali.it", "Ciao", "Ciao Barbara, come stai?"); 

i-fi?;,". . '<j9^HHÉk< ' 

Quando eseguite questo script con il browser Web, non vedrete alcun messaggio 
che confermi l'invio dell'e-mail. 

Tuttavia un'analisi della casella Posta in arrivo di Barbara rivela che il messaggio 
spedito dallo script PHP è giunto a destinazione, come mostrato nella Figura 21.1. 
11 mittente- dol messaggio ù barbara@yahoo.it. PHP utilizza mi gau-way porgli ac- 
count di posta elettronica comune a tutti i messaggi, conio dollnllo nel tile php.ini. 




Figura 21.1 

Ricezione di un breve messaggio di posta elettronica. 



In molti server, il gateway di posta per PHP coincide con l'account di posta elettro- 
nica principale del server host (per esempio root@mailserver.com). 
Per utilizzare un account di posta elettronica personale, dovreste modificare ogni 
volta il file php.ini oppure (preferibilimente) aggiungere qualche informazione di 
intestazione in più alla funzione mail( )'. 

Invio di messaggi con intestazioni 

Il quarto argomento della funzione mail( ) consente di fornire informazioni di inte- 
stazioni aggiuntive, relative al messaggio di posta elettronica che desiderate inviare. 
Se ci sono più intestazioni aggiuntive, occorre separarle con ritorni a capo e caratte- 
ri di fine riga (\r\n). L'intestazione From: specifica il vero indirizzo di posta elettro- 
nica del messaggio che vogliamo inviare. L'intestazione Reply-To: indica l'indiriz- 
zo di risposta che compare quando il destinatario fa clic sul messaggio per inviare 
una risposta. Lo script che Begue illustra l'utilizzo di queste intestazioni. 

<?php 

//Posta elettronico • Eoomplo 81-2 

m- 

Semail = "barbaramoQiiat itoat i tt*| 
$sub]ect * "Ciao" ; 

Smessaae - "Cito Barbara, oom» alali 
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Sheaders = "From: 8imotH>'clominio.net\r\n" ; 
Sheaders .= "ReplyTo: 8imon@dominio.net"; 

mail($email, Ssubject, Smessage, Sheaders); 
?> 



Per prima cosa, lo script definisce alcune variabili che servono per memorizzare i 
vari attributi richiesti dalla funzione mail ( ) : 

Semail = "barbaramega6@tiscali.it"; 
$subject = "Ciao"; 

Smessage = "Ciao Barbara, come stai? ; 

Sheaders = "From: simon@dominio.net\r\n" ; 
Sheaders .= "Reply-To: simon@dominio.net"; 

Tali attributi vengono passati sotto forma di argomenti nella chiamata alla funzione: 
maiKSemail,. Ssubject, Smessage, Sheaders) ; 

Ancora una volta, nella finestra del browser non compare alcunché, tuttavia la ca- 
^ Posta in arrivo dell'utente mostra che il messaggio è stato ricevuto e che d nut- 
rente non è più lo stesso, come mostrato nella Figura 21.2. 
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Figura 21.2 

Ricezione di un messaggio di posta elettronica con intestazioni supplem 



Invio di un messaggio HTML complesso 

A volte l'utente ha la necessità di creare messaggi più complessi, che non contenga- 
no solo testo. Per ottenere messaggi di posta elettronica più sofisticati in formato 
HTML, è necessario inserire codice HTML nell'attributo message della funzione 
mail( ). Tuttavia questo non è sufficiente affinché il messaggio di posta elettronica 
includa e venga visualizzato automaticamente come HTML. Infatti, sono necessarie 
alcune intestazioni aggiuntive per definire il tipo di contenuto del messaggio. Le in- 
tazioni in questione sono le seguenti: 

Sheaders = "MIME-Version: 1.0\r\n"; 
Sheaders .= "Content-type: text/html; charset=iso-8859-1\r\n" ; 

MIME è la sigla di Multipurpose Internet Mail Extensions, una tecnologia che esten- 
de il formato della posta Internet al fine di rendere possibile l'invio di messaggi di 
posta elettronica più complessi e non basati sul testo. Il client di posta elettronica 
deve sapere quale versione di MIME viene utilizzata, e questa informazione è speci- 
ficata dall'intestazione MIME. L'intestazione Content-type è obbligatoria e specifica 
il formato del corpo del messaggio (in questo caso testo e HTML) e il set di caratteri 

■ ' elettronica 




// Invia a 

Sto = "barbaramega@tiscali,it, "; 
Sto .= "kelly@dominio.com, "; 
Sto .= "mary@dominio.com";' 

// Oggetto del messaggio 
Ssubject = "Happy Christmas!"; 

//Messaggio HTML 
Smessage = ' 
<html> 

<body bgcolor="#FFFFCC" text="#000000"> 



<div align=" center "> 



<h1>HAPPY NEW YEAR!</h1> 
<br> 

<table width="385" border="0" cellspacing="2" cellpadding="2" 
height="74"> 

<tr bgcolor="#CC9900"> 

<td bgcolor="#CC0000">Company Meeting:</td> 

<td>20:00</td> 
</tr> 

<tr bgcolor-'#CC99M"> 

<td bQColor-"#CC«8e0">New year's Ève Party:</td> 
<td>22:80</td» 

</tr> 



</tablo> 
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</div> 
</body> 
</html> 



/:/ Per inviare posta HTML è necessario definire l'intestazione 
// Content-type 

$headers = "MIME-Version: 1.0\r\n"; i 
Sheaders .= "Content-type: text/html; charset=iso -8859-1 \r\n ; 

// Intestazione From ' 
$headers .= "From: Company Name <inf o@company .com>\r\n ; 

mail($to, Ssubject, Smessage, Sheaders); 

Innanzitutto, lo script definisce la variabile Sto, che serve per memorizzare felenco 
dei destinatari dei messaggi, e la variabile $sub j ect, che contiene il testo visualiz- 
zato nell'oggetto del messaggio: 

/; Invia 3 a I- 

$to = "barbaramega@tiscali.it, , 

Sto .= " kelly@domain.com, "; 
$to .= "mary@domain.com"; 

// Oggetto del messaggio 
Ssubject = "Happy Christmas!"; 

Il blocco successivo di codice definisce il corpo del messaggio HTML, memorizzato 
nella variabile Smessage: 

//Messaggio HTML 
Smessage = ' 
<html> 

<body bgcolor="#FFFFCC" text="#000000"> 
<div align="center"> 

<h1>HAPPY NEW YEAR!</h1> 

<Sable width="385" borderà 0" cellspacing="2" cellpadding="2" 
height="74"> 

<tr bgcolor="#CC9900"> 

<td bgcolor="#CC0000">Company Meeting :</td> 

<td>20:00</td> 

</tr> 

■ 

<tr bgcolor="#CC9900"> 

<td bgcolor="#CC0000">New year's Ève Party:</td> 

<td>22:00</td> 

</tr> 



</div> 
</body> 
</html> 



Infine, sono definite le intestazioni del messaggio e viene invocata la funzione 
mail(): 

■••vi. 

// Per inviare posta HTML è necessario definire l'intestazione 
// Content-type 

Sheaders = "MIME-Version: 1.0\r\n"; 

Sheaders .= "Content-type: text/html; charset=iso-8859-1\r\n"; 
// Intestazione From 

Sheaders .= "From: Company Name <inf o@company .com>\r\n" ; 



mail (Sto, Ssubject, Smessage, Sheaders); 



?> 



Ciascun destinatario riceverà un messaggio di posta elettronica che, una volta visualiz- 
zato con il programma di posta, assomiglierà all'esempio mostrato nella Figura 21.3. 



3l liceali Mail - Microsoft Internet fHplorer 



Etto . Modlfra Usuatela Erefwtti giumenti > 




Figura 21.3 

Ricezione di un messaggio di poiU •tettron* 4 HTML complesso. 



Creazione di un modulo di posta elettronica 



Sempre più spesso, i sili Web mettono a disposizione dell'utente moduli di posta 
elettronica per inviare messaggi direttamente all'amministratore del sito o a singole 
persone all'interno di un'organizzazione. In genere questi moduli prendono il nome 
di "modulo di feedback" o "modulo di posta elettronica". Per creare un tipico mo- 
dulo di feedback, è sufficiente un semplice modulo HTML con tre o più caselle di 
testo e un pulsante di invio (in qualche caso è presente anche un pulsante di ripri- 
stino per reimpostare tutti i dati contenuti nei campi). 

La prima casella di testo contiene il nome dell'utente che invia il messaggio. La se- 
conda contiene il messaggio di posta elettronica dell'utente in modo che il sito pos- 
sa rispondere, mentre nella terza casella di testo si trova il vero contenuto del mes- 
saggio. Ecco un esempio di un modulo simile: 

<?php 

//Posta elettronica - Esempio 21-4 

// 

lise viene premuto il pulsante, invia il messaggio 



if (isset($_POST[ "submit"])) { 
$name = $ P0ST[ "name" ] ; 



$message = $_P0ST[ "message" ] ; 
$email = $_P0ST[ "email" ] ; 

$comments = "Sname wrote: /n/n $message"; 
Ssendmail = mail ( "barbaramega@tiscali.it" , $cc 
"Frc 




if (Ssendmail) 

echo "Invio del messaggio riuscito!"; 
else 

echo "Impossibile inviare il messaggio"; 

.fife,' ' ' ', " " ' ' ■■ • 

?> 7, . " ' . 

<html> 

<body bgcolor="#FFFFFF" text="#000000"> 

<form name="form1" method="post" action=" <?php 
echo $_SERVER[ "PHP_SELF" ];?>"> 

<b>Inviateci un messaggio :</b><br> 

<table width="75%" border="0" cellspacing="0" cellpadding="0" 
height="182"> 

i 

<tr> 

<td>Nome:</td> 

<td><input type="text" name="name"></td> 
</tr> 



<tr> 



<td>E-mail:</td> 

<td><input type="text" name="email"></td> 
</tr> 

<tr> 

<td>Messaggio:</td> 
<td> 

<textarea name="message" cols="40" rows="4"></textarea> 
</td> 
</tr> 

</table> 

<input type="submit" name=" submit" value=" Invia messaggio"> 
<input type=" reset" name=" reset" value=" Reimposta "> 

</form> 
</body> 
</html> 

La prima parte dello script verifica se il modulo è stato inviato: 
if(isset($_POST[ "submit"])) { 

In caso affermativo, i dati vengono estratti dal modulo e la funzione mail( ) invia il 
messaggio di posta elettronica: 

Sname = $_P0ST[ "name" ] ; 
Smessage = $_POST[ "message" ] ; 
$email = $_POST[ "email" ] ; 

Scomments = "Sname wrote: /n/n Smessage"; 

Ssendmail = mail( "barbaramega@tiscali.it" , Scomments, Smessage, 
"From: Semail"); 



Quindi compare una comunicazione che annuncia se il messaggio è stato inviato 



correttamente-. 



if (Ssendmail) 

echo "Invio del messaggio riuscito!"; 
else 

echo "Impossibile inviare il messaggio»; 



La parte finale dello script visualizza il modulo HTML: 
khtml> 

<body bgcolor="#FFFFFF" text=" #000000 "> 

<form name="form1" method="post" action=" <?php 
echo $_SERVER [ " PHP_SELF "];?>"> 

<b>lnviateci un m888aggio:</b><br> 

<table width-"78V border-"0" cellspacing="0" cellpadding="0" 
height-"182"> 

<tr> 

<td>NOI»0l«/ 
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<td><lnput type-"text" name="name"></td> 
</tr> 

<tr> 

<td>E-mail:</td> 

<td><input type="text" name=" email" ></td> 
</tr> 



<tr> 

<td>Messaggio : </td> 
<td> 

<textarea name="message" cols="40"rows="4"></textarea> 
</td> 
</tr> 

. 

</table> 

<input type="submit" name="submit" value="Invia messaggio > 
<input type=" reset" name=" reset" value=" Reimposta 1 ^ 

</form> 
</body> 
</html> 

La Figura 21.4 illustra il modulo che l'utente deve utilizzare per inviare un messag- 
gio di posta elettronica. 



3 http://loc3lhost/phpbook/esempio21-4.php - Microsoft Internet Explorer 
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Figura 21.4 

Un semplice modulo di posta Web. 




invio 01 messaggi ai posui eieiuuii».a 



Riepilogo 

Questo capitolo ha mostrato come utilizzare PHP per inviare un messaggio di posta 
elettronica a un utente in modo completamente automatico, o con l'interazione da 
parte dell'utente tramite un modulo di posta Web. Sono stati presentati due stili di- 
versi di messaggi, dando così la possibilità all'utente di inviare sia messaggi semplici 
sia messaggi più complessi. 

Il prossimo capitolo introdurrà il concetto di cookie e mostrerà come ì cookie pos- 
sano essere utilizzati per interagire con l'utente. 
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Cookie 
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■ 
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Introduzione 

Questo capitolo introduce il concetto di cookie, un mezzo per memorizzare dati va- 
riabili a livello locale sul computer dell'utente. I cookie possono essere memorizzati 
sul computer di tutti gli utenti e i dati conservati in ciascuno di questi cookie posso- 
no essere diversi. Grazie ai cookie è pertanto possibile memorizzare le preferenze 
degli utenti in modo da offrire un'esperienza dinamica personalizzata per ciascun 
utente che accede a un sito Web. Un esempio comune di quanto appena detto sono 
commerce che consentono a tutti gli utenti di selezionare i diversi prodotti 
desiderano acquistare. 

Creazione di un cookie 

Per la creazione di un cookie è necessario ricorrere alla funzione setcookie ( ) . 
sintassi della funzione è la seguente. 

iol, setcookie (string nome , string valore , int scadenza , string 
•rcorso, string dominio, int sicuro ) 

Con la funzione setcookie () tutti gli argomenti sono facoltativi, tranne il nome. 
Nel caso in cui sia presente solo l'argomento nome, un cookie con quel nome sarà 
cancellato dal client remoto. Al fine di saltare qualunque argomento, potete anche 
sostituirlo con una stringa vuota (" "). 

abella seguente descrive gli argomenti e il tipo di valore restituito dalla tun- 

•ne. 





Nome 


Tipo 


Descrizione 


nome 
valore 
scadenza 


string 
•tring 
int 


Nome del file del cookie. 

Dati da memorizzare nel file del cookie. 

Stringa di data che definisce la durata del 

cookie. 

Sottolnsleme ili URL di un dominio per il 
quale II cookie è valido. 


percorso 


•tring 


( Sffiiw) 
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Nome Tipo Descrizione 

dominio string Attribuii di dominio del cookie realizzati 

con il nome di dominio Internet dell'host 
dal quale l'URL verrà raggiunto. 

sicuro boolean Se impostato a "1" verrà trasmesso solo se il 

canale di comunicazione con l'host è sicuro. 

Restituzione di setcookie ( ) boolean TRUE in caso di suc cesso, altrimenti FALSE. 

Esempi di funzioni: 

setcookie ( "TestCookie" , $value); 

setcookie ("TestCookie", $value, tinte () +3600) ; 

setcookie ("TestCookie", Svalue, time () +3600, "/nomeutente/ " , 

"dorainio.com", 1); 

Quando utilizzate la funzione per la generazione di cookie, dovete tenere presenti 
le considerazioni illustrate di seguito. 

• I cookie non diventeranno visibili fino al successivo caricamento della pagi- 
na per la quale il cookie dev'essere visibile. Per verificare se l'impostazione 
di un cookie è riuscita, verificatene la presenza al successivo caricamento 
della pagina prima della sua scadenza. L'ora di scadenza viene impostata 
con il parametro scadenza. 

• I cookie devono essere eliminati con gli stessi parametri con i quali sono 
stati impostati. 

• I nomi dei cookie possono essere impostati come nomi di array e saranno 
disponibili per gli script PHP come array; tuttavia sul sistema dell'utente 
vengono memorizzati cookie separati. Potreste prendere in considerazio- 
ne l'utilizzo delle funzioni explode() o serialize() per impostare un 
cookie con più nomi e valori. 

Considerate l'esempio seguente che illustra la funzione setcookie ( ): 

<?php 

// Cookie - Esempio 22-1 

$value = "Salve, questo è del testo in un cookie"; 
setcookie ("TestCookie", $value,time 0+3600) ; 

?'*' '■. ■'■ ">'•"' ■■'■>■; ' ; ' '!';,;.''' \ :v V '■ "'• 

L'output di questo script non è molto interessante, in quanto non viene visualizza- 
to alcunché e lo schermo del browser rimane vuoto. Per vedere se l'impostazione 
del cookie è riuscita, dovete sapere come leggerlo. 

Lettura di un cookie 

La visualizzazioni- 1- l'accesso ai cookie è semplice; è sufficienti- ti. ut. irli ionie una 
variabile prcdcflnltA, Nel Capitolo 9 si è accennato al fatto ilu- l'in vi uhi > alle varia- 
bili ilei cookie può avveniri' con l'array $ COOKIE, c e | tic verificare acce 



<_ooKie t<*i 



dendo a esse. Pdcordate che i cookie non saranno visibili fino al caricamento della 
pagina per la quale il cookie deve essere visibile. Per verificare se l'impostazione 
di un cookie è riuscita, verificatene la presenza al successivo caricamento della 
pagina prima della sua scadenza. Lo script che segue conferma che è possibile ac- 



cedere ai cookie creati e quindi visualizzarli 
<?php 



■ 

Il Cookie - Esempio 22-2 

// 

Svalue = "Salve, questo è del testo in un cookie"; 
setcookie ("TestCookie", $value,time( )+3600) ; 

<html> 
<body> 

<b>TestCookie contiene :</b> . 

<?php echo($_COOKlE["TestCookie"]); ?> 

</body> 
</html> 



L'output di questo script è quello della Figura 22.1, 



3 http://localhost/phpbook/esempio22-2.php - Microsoft Internet Expli 
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|http;//localhost/phpbook/esempio22-2.php 



TestCookie contiene: Salve, questo è del testo in un cookie 



| Operazione completata ; ) 



Figura 22. 1 

Visualizzazione di una variabile cookie. 



Un altro modo per verificare se un cookie è stato impostato correttamente e quindi 
leggerne i dati prevede il ricorso alla funzione phpinf o( ) : 

<?php 



Esemplo 22-3 
Svalue = "Salvo, quottO * 



// Cookie 

// 



n , nnklo" 
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setcookie ( "TestCookie" , Svalue ,t ime () +3600) 
?> 

<html> 
<body> 



<?php phpinfo() ;?> 

</body> 
</html> 



■ 



Questo script invoca la funzione phpinf o ( ) , che visualizza le informazioni sull'am- 
biente PHP. Quando le informazioni appaiono sullo schermo, è sufficiente far scor- 
rere la finestra del browser per giungere alla sezione relativa alle variabili PHP. No- 
tate che la seconda e la terza riga nella tabella delle variabili PHP contengono le 
voci seguenti: _C00KIE[ "TestCookie" ] . 
La Figura 22.2 illustra quanto appena affermato. 



IjphpinfoO - Microsoft Internet Bipto'» 
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PHP Variables 




Val " e 


_REQUEST|"TestCookie"] 


Salve, questo è del lesto in un cookie 


COOKIE["TestCookle"l 


Salve, questo è del testo in un cookie 


SERWERl'-ALLUSERSPROFILE"] 


EfflDocuments and SettlngsttAII Users 


_SERVER 

["CommonProorainFilBS"] 


E:WrogrammlVtFlle comuni 

■ 


SERVERl"COMPUTERNAME"l 


ARCIUK 


SERVE R["ComSpec"] 


EAWVHNNT\lsystem32temd.exe 


_SERVER["CONTENT_LENGTH") 


0 ' .... 


SERVER 
["GATEWAYJNTERFACE"] 


COI/1 .1 


_SERVERI"HTTPS"1 




_SERVERI"HTTP_ACCEPT"1 


image/gif, image/x-xoitmap, irnageflpeg, tmage/pipeg, 
applicatlonMid.ms-powerpoint, application/Vnd.ms-excel, 
applicationfmsword, "t" 


SERVER 
1"HTTP_ACCEPT_LANGUAGE"] 


it 


SERVER["HTTP_CONNECTI0N"l 


Keep-Alive 



Figura 22.2 

Visualizzazione dei cookie con phpinfoQ. 
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Eliminazione di un cookie 

Avete già visto che i cookie possono essere creati con una scadenza incorporata; 
ma che cosa accade se si desidera eliminare un cookie che non contiene tale sca- 
denza o se lo si vuole cancellare prima di quanto stabilito? Per forzare la scadenza 
di un cookie, impostate una scadenza negativa utilizzando la stessa sintassi impie- 
gata per la creazione del cookie. 

setcookie ("TestCookie", " " ,time( ) -3600) ; 
setcookie ("TestCookie", " " ,time( ) -3600, "/nomeutente/ " , 
"dominio.com", 1); 

oppure 

setcookie ("TestCookie"); 



Cookie 



enti attay 




È possibile memorizzare un array in un cookie, tuttavia è necessario memorizzare 

separatamente ciascun elemento dell'array nel cookie, come nell'esempio seguente: 

"r 

setcookie ( "cookie[0] " , "cookietre" ) ; 
setcookie ( " cookie [1 ] " , "cookiedue" ) ; 
setcookie ( "cookie[2] " , "cookieuno" ) : 

Benché gli elementi debbano essere memorizzati separatamente, quando l'array 
viene letto viene restituito come array al quale è possibile accedere: 

$list = $_C00KIE[ "cookie" ] ; 

Lo script che segue illustra l'impostazione e l'accesso di un array attraverso i cookie: 
<?php 

Il Cookie - Esempio 22-4 

P;-- ' 

$address = $_SERVER[ ' REMOTE_ADDR ' ] ; 
$browser = $_SERVER[ ' HTTP_USER_AGENT' ] ; 
$0S = $ SERVER [ 'OS' 1 ; 



setcookie ( "cookie[0] " , "$address", time()+200); 
setcookie ( "cookie! 1 ]" , "$browser", time( )+200) ; 
setcookie ( "cookie[2] " , "$os", time()+200); 

f> 

<html> 
<body> 
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echo "<b> Indirizzo IP:</b> $list[0]"; 
echo "<br>"; 

echo "<b> Browser del client:</b> $list[1]"; 
echo "<br>"; 

echo "<b> Sistema operativo:</b> $list[2]"; 



</body> 
</html> 



L'output di questo script è quello della Figura 22.3- 



3http://lotalhost/phpbook/esei^o2Z-_^hp_- _Microsoftlnternel 



File Modifica Visualizza Preferii Strumenti ? 



4* indietro V* V ® ® ' MMSÌ? Si Preferiti (^Multimedie ^ | |à; #_ 



^http://localhost;phpboQ^esempio22-4,php_ 



~3 *> w [Collegamenti 



Indirizzo IP: 127.0.0.1 

Browser del clienti Mozilla/4. 0 (compatìble; MSIE 6.0; "Windows NT 5.0) 
Sistema operativo: Windows_NT 



I Operazione completata 



Figura 22.3 

Array e cookie. 



Cookie a più dati 

Un altro metodo per memorizzare più dati in un cookie consiste nel creare una 
stringa contenente tutte le informazioni preferenziali e passarla come singolo valore 
al cookie. Si può poi utilizzare la funzione explode( ) per estrarre tutte le informa- 
zioni dal cookie. Questa tecnica richiede una struttura più complessa, affinché i dati 
siano inseriti nel coolde, ma non richiede un array di cookie. 
Considerate l'esempio che segue, che è una riscrittura dello script precedente ma 
utilizza il metodo dei dati multipli. 

<?php 

// Cookie - Esempio 22-5 
// 1 

Saddress = $ SERVER! ' REMOTE_ADDR 1 ] ; 
Sbrowser = $~SERVER [ 1 HTTP_USER_AGENT ' ] ; 

$os = $_SERVER[ '08' li 
$info = "SnddroMi :$browser: :$os" ; 
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setcookie ("data", "Sinfo", time()+200); 

1> -«ftp HA» ' 

<html> 
<body> 

<?php 



Sreadcookie = $_COOKIE[ "data" ] ; 
Slist = explode ("::", Sreadcookie); 

echo "<b> Indirizzo IP:</b> $list[0]"; 
echo "<br>"; 

echo "<b> Browser del clienti </b> $list[1]"; 
echo "<br>"; 
echo "<b> Sistema operativo:</b> $list[2]"; 

?> 



</body> 
</html> 



Creazione di un sistema per l'accesso 

I cookie possono essere utilizzati per creare un sistema di accesso riservato a utenti 
registrati. Per ottenere il nome utente e la password corretti verrà utilizzato un mo- 
dulo. In caso di accesso riuscito, il nome utente fornito viene aggiunto da un cookie 
presente sul computer del client. Il sistema verifica se il cookie esiste: in caso affer- 
mativo, viene visualizzato un messaggio "Ciao nomeutente", altrimenti compare il 
messaggio "Nome utente o password non validi": 

<?ph P 

// Cookie - Esempio 22-6 
1/ 



Susername = "Simon"; 
Spassword = "12345"; 

if (isset($_POST[ 'login' ])){ 

if ($_POST[ 'user ' ] == "Susername" && $_P0ST[ 1 pass 1 ] == "Spassword" 

mi ; 

setcookief "member" , "Susername", time()+600); 
}else{ 

echo "Nome utente o password non validi"; • 

} 

W 
?> 



<html> 
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<head> 

<title>Membri</title> 
</head> 

<body bgcolor="#FFFFFF" text=" #000000 "> 
<?php 

if (isset($_COOKIE[ l member l ])){ 

echo "Ciao <b> S_COOKIE[member] </b>"; 

> else{ 

echo "<b>Accesso non avvenuto </b> ; 
echo "<form name=' formi ' method='post' action=''>"; 
echo "Nome utente: <input type='text' name= 1 user 1 ><br>" ; 
echo "Password: <input type=' password 1 narae='pass'><br>" ; 
echo "<input type=' submit" name='login' value=' Accedi alla 

pagina riservata '>" ; 
echo "</form>"; 

} 



?> 

</body> 
</html> 



L'output di questo script è quello della Figura 22.4. 



'3 Membri - Microsoft Internet Ex plore r 




Figura 22.4 

Utenti del sistema. 



Lo .script precedente mostra come consentire agli utenti del sistema ili accedere. Lo 
script che segue pili . essere impiegalo per eseguire l'aulenti. .1/1. .ne tu qualunque pa- 
gina del sito riservala a specifici nienti e reindirizzare quelli non .mi. .lizzali a una pa- 
U i n;1 di accesso Se II cookie esiste, lo script "reimposta la • wktm tlel cookie a IO 



i. Questo script dev'essere collocato su tutte le pagine del sistema dedicato a 
specifici utenti. Il file dev'essere quindi incluso all'inizio di tutte le pagine. 



<?php 



// Cookie - Esempio 22-7 
// 

if (isset($_COOKIE[ 'member' ])){ 

setcookie("member", "$_C00KI E [member] " , time()+600); 
}else{ 

HEADERC location: esempio22-6.php" ) ; 

! ° 

|?> 

Questo script utilizza la funzione header() per reindirizzare automaticamente 

l'utente a una nuova pagina Web. 

La sintassi della funzione è la seguente. 

Int header{string indirizzo); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione 



Nome 


Tipo 


Descrizione 




indirizzo 

Restituzione di header( ) 


string 
int 


Indirizzo della pagina Web. 

Restituisce TRUE se il reindirizzamento va bene 

FALSE in caso contrario. 



Riepilogo 

Questo capitolo ha introdotto il concetto di cookie e ne ha illustrato l'impiego. Si j 
visto come i cookie possano essere impostati e rimossi, se necessario. Nel prossimi 
capitolo verrà introdotta una tecnologia simile, quella delle sessioni. 



Capitolo 23 

Gestione delle sessioni 



H 

Introduzione 

• 

Nel capitolo precedente avete visto che i cookie possono essere utili nella gestione 
di informazioni specifiche dell'utente. Tuttavia i cookie possono essere disabilitati 
e/o cancellati. Ciò di cui avete veramente bisogno è uno strumento con cui creare 
informazioni specifiche dell'utente (che si conservino nei molteplici accessi Web) e 
che consenta di eseguire tutte queste operazioni nel modo più automatico possibi- 
le. Il supporto alle sessioni in PHP offre questa funzionalità che, come vedrete in se- 
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guito, consente di realizzare siti Web molto più interessanti che rendono possibili 
personalizzazioni più specifiche relative all'utente. 

Che cosa sono le sessioni 



Le sessioni sono un meccanismo per memorizzare informazioni diverse per ciascun 
utente che accede al sistema Web. In pratica, le sessioni permettono di memorizza- 
re le variabili e i relativi valori per ogni utente. 1 valori di queste variabili possono 
differire da utente a utente, e questo consente di assegnare a utenti diversi poten- 
zialità differenti. 



Come funzionano le sessioni 

Le sessioni funzionano assegnando a un visitatore un ID univoco, noto come ID di 
sessione. Tale valore può essere memorizzato direttamente dall'utente in un cookie, 
oppure viene incorporato come parte dell'URL. Di seguito si riporta un esempio di 
ID di sessione. 

Sess_f231be97d46fb1ca96c1323e88f4523f 

Nel server viene ovali > un Ilio . li sessione con lo stesso nome. Questo file serve per 
memorizzale i valori delle v .nubili .assegnate alla sessione. Il contenuto di un file di 
sessione potrebbe averi il n'allenii uspelto: 



count|i:18;name|i:B: ■ 



In questo esempio, count è una variabile memorizx.au ..«•!! La variabile 

count è di tipo intero e contiene il valore 18; name è invi-, e UM W&l&ile di tipo 

»^ a lSSsS^ invocare la funzione session_start( ). 



Quindi, per creare una sessione occorre invocare la funzione v , , 

La sintassi della funzione è la seguente. 

bool session_start(void) 

La tabella seguente descrive il tipo di valore restituito dalla funzione. 



Nome Tipo Descrizione 

Restituzione di session_start ( ) boolean Kesutu isce TRUE. 

Esempio di funzione: 
session_start() ; * , 

La funzione session_start ( ) controlla se per l'utente in questione è stata creata 
una sessione e, in caso negativo, ne crea una. Se esiste già una sessione, W le va- 
riabili e i relativi valori vengono recuperati e resi disponibili. La funzione restituisce 

Sanabili delle sessioni sono registrate con l'array associativo $_SESSION. Per 
esempio: 

; 

$_SESSI0N[ 'count' 1 = 0; 

Questa riga di codice registra, insieme alla sessione, una variabile di nome count. 
Ciascun utente avrà il proprio file di sessione separato e i propri valori delle variato- 
li Il paragrafo che segue prende in considerazione un semplice esempio. 



Conteggio del numero di accessi 

Sfruttando quello che abbiamo imparato finora, possiamo utilizzare le sessioni per 
accertare quante volte un utente specifico ha tentato di accedere a una pagina. Con- 
siderate lo script seguente: 



<?php 




// Sessioni - Esempio 23-1 

session_start() ; 
if (!isset($_SESSION[ 'count' ])) 

$_SESSION[ 'count' ] = 0; 

else 

$ SESSIONI 'count' ]++; oBoOTitaif »„*.ìk*»i 

echo _ "Ciao, questa pagina è stata visitata da te ». $_SESSION[ count ]. 

» volte."; 

?> 



Questo script invoca la funzione session_start( ) sia per creare una nuova ses- 
sione sia per accedere a una già esistente. La variabile count è registrata insieme 
alla sessione e viene impostata a 0 nel caso in cui non sia ancora stata registrata: 

if (!isset($_SESSION[' count'])) 
$_SESSION[ 'count'] = 0; 

In caso contrario, il valore della variabile count viene incrementato e viene utilizza- 
ta un'istruzione echo per visualizzarne il contenuto: 

else 

$_SESSION [ 1 count ' ] ++ ; 
echo "Ciao, questa pagina è stata visitata da te ". $_SESSION[ "count" ] . 
" volte."; 

Ogni volta che l'utente accede alla pagina, il valore di $count viene incrementato e 
memorizzato nella sessione. Il risultato è la creazione di un contatore specifico per 
l'utente, che registra quante volte un determinato utente accede alla pagina. L'out- 
put ottenuto da questo script è quello della Figura 23.1. 



3; hUp://localhost/phpbook/esempio23-l.php - Microsoft Internet Explorer 


File Modifica Visuali22a Preferiti Strumenti ? 

. i. -, -sì r» M i .«k, ■ , „. „. ... Aia i m usa. 


m 


<#» inaecro ~;:r>> ' '.%f ivj tuJ j <4jv*w 1 Krererro ^muitimeaia \ i^r ^ . 
Indirizzo |||) http;//localhost/phpbook/esempio23-l.php j\ ftvà Collegamenti 


» 


Ciao, questa pagina è stata visitata da te 3 volte. 














- . 





Figura 23. 1 

Contatore degli accessi alla pagina di un utente, 

Ovviamente la Figura 23.1 non dimostra che la sessione sia effettivamente in funzio- 
ne. Ciò che dovete fare è invitare un altro utente ad accedere alla stessa pagina e 
vedere se lo script è in grado di tenere traccia dei suoi accessi, senza interferire con 
i* vostri tentativi. Un modo per duplicare questa situazione consiste nell'aprire una 
nuova finestra del browser e puntarla al medesimo script. Le due finestre del brow- 
ser dovrebbero gestire gli accessi alla pagina in modo separato per ciascun "utente". 
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Come ottenere un ID di sessione 

Con la funzione session_id( ) è possibile ottenere il vali uv ilell'ID eli sessione cor- 
rente. 

La sintassi della funzione è la seguente. 



string session_id( [string id] ) ; 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 









Nome 


Tipo 


Descrizione 


id 

Restituzione di session_id( ) 


string 
string 


ID di sessione sostitutivo. 
ID di sessione. 


Esempio di funzione: 







$id = session_id{) ; 



Scelta dei colori della pagina 
da parte dell'utente 

In questo capitolo si è detto che le sessioni consentono di personalizzare una pagi- 
na Web per i singoli utenti, ma finora avete avuto ben poche prove di questa affer- 
mazione. È arrivato il momento di sfruttare quanto appreso per creare uno script in 
grado di permettere a un utente di cambiare il colore di sfondo della pagina Web. 
Lo script che segue mostra, utilizzando le variabili di sessione, come un utente pos- 
sa regolare a proprio piacimento i colori di sfondo e di primo piano di un sito Web. 

<?php 

// Sessioni - Esempio 23-2 

session start{) ; 

if (l isset ($_SESSION[ ' bgCol 1 ] ) ) 

$_SESSION['bgCol'] = 0; 
if ( I isset ($_SESSION[ 1 textCol' ] ) ) 

$_SESSI0N[ 'textcol' 1=0; 

if (isset($_POST["submit"]>) { 
SbgCol = $_POST["nbgCol"]; 
StextCol = $_POST[ "ntextCol" 1 ; 
$_session[ 'bgCol' ] ■ SbgCol; 
$_SESSION[ 'textCol' | - StoxtCol; 
echo("<body bgcolor-'IbgCol' text='$textCol'>" ) ; 

} 

?> 



<h2>Quali colori pr«f»rli0i?«/h2> 



forni action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' inethod='post'> 

Dlore di sfondo: <select name='nbgCol'> 
<option>rosso</option> 
<option>verde</option> 
<option>blu</option> 
<option>azzurro</option> 
<option>giallo</option> 
</select> 

<br> 

Colore del testo: <select name=' ntextCol '> 
<option>rosso</option> 
<option>verde</option> 
<option>blu</option> 
<option>azzurro</option> 
<option>giallo</option> 
</select> 

<br><br> 

<input type='submit' name='submit l > 
</form> 

Lo script inizia dichiarando una sessione e registrando due variabili: 
Restart (); 

if (1 isset ($_SESSION[ 'bgCol' ])) 

$_SESSION['bgCòl'] =0; 
if ( 1 isset ($_SESSI0N[ ' textCol 1 ] ) ) 

$_SESSI0N[ ■textcol'] = 0; 

I valori delle variabili del modulo $nbgCol e $ntextCol vengono controllati per 
vedere se sono stati ricevuti. In caso affermativo, le variabili della sessione vengono 
Impostate a questi nuovi valori: 

if (isset($_POST["subinit"])) { 
$bgCol = $_POST["nbgCol"]; 
StextCol = $_POST[ "ntextCol"]; 
$_SESSION[ 'bgCol' ] = SbgCol; 
$_SESSIONrtextCol']= StextCol; 
echo("<body bgcolor=' SbgCol 1 text=' StextCol '>"); 

La parte restante dello script visualizza l'elemento body con gli attributi bgcolor e 
text per permettere di modificare il colore dello sfondo e del testo in primo piano. 
Viene inoltre visualizzato il modulo per dare la possibilità di scegliere il colore di 
sfondo da un menu di selezione: 

<h2>Quali colori pref erisci?</h2> 

<forra action='<?php echo($_SERVER[ "PHP_SELF" ] ) ?>' method= , post'> 

Colore di sfondo: <select name='nbgCol'> 
<option>roBBo</option> 
<opt ion> vtrdt< / opt ion> 
<option>blu</opt mi, 
<option>*!iurro«/opt lon> 
<optlon>glal)o«/opt ion> 
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<br> 

Colore del testo: 



</select> 

<select name='ntextCol'> 

<option>rosso</option> 

<option>verde</option> 

<opt ion>blu< / option> 

<option>azzurro</option> 

<option>giallo</option> 

</select> 



<br><br> 

<input type='submit' 
</form> 



naine= ' submit 1 > 



L'output ottenuto da questo script è quello della Figura 23.2. 



" : m httD^/iocafhost/phpboo^ Interne t Explorer 



File Modifica Visualizza Preferiti Strumenti 



^Indietro jg} ^ [Cjcefca &J Preferiti ^Multirnedla $ | %r #_ 



Indirizzo 1^) http : ;/localhost/phpbook fcsernpio23-2.php 



"▼j if y-Val | Collegamenti " 



Quali colori preferisci? 



Colore di sfondo: | rosso jj 
Colore del testo: | rosso zi 



| Operazione completata 



! Intranet locale 



Figura 23.2 

Modifica dei colori. 



Ancora una volta dovrete aprire una seconda finestra del browser per dimostrare 
che l'aspetto della sessione della pagina Web sia effettivamente personalizzato per 
l'utente. 

■ 

Annullamento della registrazione 

. .. • L'I" 

delle variabili 

È possibile annullare la registrazione delle variabili di sessione. Scopo di questa 
operazione potrebbe essere quello di accertarsi che la sessione creata sia completa- 
mente priva di valori di variabili. La funzione unset() elimina una variabile regi- 
strata insiemi- alla sessione. 
La sintassi della l'unzione è la seguente. 



void unsot(mixed variabile); 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


variabile 


mixed 


La variabile per la quale si deve annullare la 






registrazione. 


Restituzione di unset() 


void 


Non restituisce alcunché 



Esempio di funzione: 
unset($_SESSION[ 'bgCol' ] ) 

Migliore accessibilità alle pagine 

Rendere le pagine Web accessibili al maggior numero possibile di utenti è una parte 
importante della progettazione delle pagine Web. Nell'esempio seguente, vedrete 
come un utente possa regolare la dimensione del testo di una pagina Web. L'esem- 
pio utilizza due pagine Web separate per dimostrare che i valori delle sessioni sono 
accessibili in più pagine di un unico sito Web. Il primo script, che apre una sessio- 
ne, dovrebbe essere salvato con il nome "esempio23-3.php": 

<?php 

// Sessioni - Esempio 23-3 

session_start( ) ; 
if (isset($_SESSION[ 'size'])) 
$size = $_SESSION['size']; 

else 

$size = 3; 
echo( "<basefont size=$size>" ) ; 

?> 



Benvenuti alla pagina principale. Osservate che il testo viene 
visualizzato con una dimensione di font che può essere regolata facendo 
clic <a href=esempio23-4.php>qui</a>. 

|| valore di size viene utilizzato per modificare il : 



echo("<basefont size=$size>" ) ; 



?> 




Gli utenti possono decidere di modificare il font di base facendo clic sul collega 
mento ipertestuale: 

Benvenuti alla pagina principale. Osservate che il testo viene 
visualizzato con una dimensione di font che può essere regolata facendo 
clic <a href=esempio23-4.php>qui</a>. 



L'output ottenuto da que.sK i s< ript e quello della l'iguia 1 \ \ 



-ahttp://locallnisl/|)li|)lii)ol</i-sriii|)iii^:i-3.php - Microsoft Internet Explorer 



File Modifica Visualizza Proferiti Strumenti ? 



Indirizzo http;;;iocalhost/phpbookjesempio23-3,php 



Indietro <• •+ ■ ~<Q> |g & 1 i$Cerca Preferii! ^Multimed ia 0 | 



£>Va\ I Collegamenti 



Benvenuti alla pagina principale. Osservate che il testo viene visualizzato con una dimensione 
di font che può essere regolata facendo clic gm. 



PI?} Operazione completata 



Figura 23.3 

Dimensione iniziale del font. 



Un clic sul collegamento ipertestuale in questo script invoca lo script seguente: 

* 

<?php 

// Sessioni - Esempio 23-4 
// 



i 



session_start() ; 
if (isset($_POST[ 'submit' ] )) { 
$size = $_P0ST[ 'size'lj 

$_SESSION[ 'size' ] = $size; 

} ■ 
else { 

if (isset($_SESSION['size'])) 
$size = $_SESSI0N[ 1 size 1 ] ; 

else 

Ssize = 3; 
echo(''<basefont size=$size>» ) ; 
?> 

Viene visualizzato un modulo con un menu di selezione che consente all'utente di 
cambiare la dimensione corrente del font: 

<form action='<?php echo $_SERVER [ 1 PHP_SELF ' ] ?>' method='post >> 

Dimensione del testo: <select name='size'> 
<option>K/option> 
<option>2</option> 
<option>3</option> 
<option>4</option> 
<option>5</option> 
</select> 



<br><br> 

<input type=' submit' name=' submit '> 



</form> 

Torna <a href="esempio23-3. php">Torna</a> alla pagina principale. 

Lo script deve essere salvato con il nome "esempio23-4.php". Inizia accedendo alla 
sessione, controlla se la variabile size del modulo è stata ricevuta e infine visualiz- 
za il font di base con il valore della variabile $size: 

session_start(); 
if (isset($_POST[ 'submit'])) { 
$size = $_POST['size']; 

$_SESSI0N[ 'size' ] = $size; 

else { 

if (isset($_SESSION['size'])) 
Ssize = $ SESSIONI 'size' ] ; 

else 

Ssize = 3; 

} 

echo( "<basefont size=$size>" ) ; 
?> 



Compare quindi un modulo con un menu di selezione che consente all'utente di 
modificare la dimensione corrente del testo: 

i 

<form action='<?php echo $_SERVER[ 'PHP_SELF' ] ?>' method='post'> 

Dimensione del testo: <select name='size'> 
<option>K/option> 
<option>2</option> 
<option>3</option> 
<option>4</option> 



<option>5</options 



" 



i„-><br> </seiect> 
<input type=' submit' name=' submit ' > 
</form> 

Torna <a href="esempio23-3.php">Torna</a> alla pagina principale. 

La Figura 23.4 illustra l'output ottenuto da questo script dopo che l'utente ha sele- 
zionato 5 come dimensione di font. 

Se fate clic sul collegamento ipertestuale Torna in, questa pagina, tornerete alla pa- 
gina esempio23-3.php originale. Il testo di questa pagina avrà una dimensione pari 
a 5. La dimensione del testo sarà conservata nei passaggi da una pagina all'altra, 
fino a quando non deciderete di modificarla di nuovo. 
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3 http:.. /Inc.lhosl/pl.iil-nk/.-sr.i >r.\ l.php - Microsoft Internet Ewplorw 



Fila Modifica Vlsuataa Preferiti Strumenti ? 



indietro 7+- <Q \£ $ I ^Corca [AJ Preferiti ^Mtteedla y-J , ^. 



I http://localhost/phpbool</esemplo23-4.php 



"3 ^ Val | ColleqamenH 



Viene visualizzato un modulo con un menu di selezione che 
consente all'utente di cambiare la dimensione corrente del 
font: Regolazione della dimensione del testo 



Dimensione del testo: E 



Torna alla pagina principale. 




Figura 23.4 

È stata selezionata la dimensione di font 5. 



Riepilogo 



■ 

Questo capitolo ha introdotto il concetto di sessione e ha spiegato come creare e 
memorizzare i valori delle variabili che possono essere modificati per ì singoli uten- 
ti. Il prossimo capitolo analizzerà il concetto di gestione degli errori e spiegherà 
come conferire un aspetto più professionale alle applicazioni Web. 



- 



■ 



Parte VI 

Gestione degli errori 
ebuffering 



24 Gestione degli errori 

25 Buffering dell'output 



Capitolo 24 

Gestione degli errori 



Introduzione 

Lo sviluppo di codice privo di errori è l'utopia degli ingegneri del software, ma sfor- 
tunatamente la ricerca di metodi e strumenti che consentano di raggiungere questo 
risultato non può dirsi terminata. Nel frattempo, è necessario fare i conti con gli er- 
rori dei programmi. Molti linguaggi di programmazione, tuttavia, offrono allo svi- 
luppatore la possibilità di individuare gli errori quando si verificano e quindi agire 
di conseguenza. Questa azione potrebbe consistere semplicemente nella visualizza- 
zione di un messaggio di errore che avvisa l'utente che è accaduto qualcosa, pur 
consentendo la prosecuzione dell'esecuzione del programma. In altri casi molto più 
gravi, invece, il programma potrebbe dover essere interrotto immediatamente. 
Questo capitolo presenta le capacità di gestione degli errori di PHP, che consento- 
no non solo di determinare quali errori verranno visualizzati agli utenti, ma anche di 
scrivere funzioni di gestione degli errori personalizzate. Si vedrà inoltre come inne- 
scare i propri messaggi di errore quando occorre e come registrare gli errori per 
esaminarli in futuro. 

i; 

Tipi di errore 

Normalmente, quando uno script PHP contiene un errore, il parser visualizza un 
messaggio che indica di che errore si tratta, in quale script si è verificato e in quale 
linea del codice è stato rilevato. In relazione alla gravità dell'errore, l'esecuzione 
dello script potrebbe essere inte'rrotta a questo punto, oppure continuare. Mentre i 
messaggi di errore possono essere tollerati in un ambiente di sviluppo, essi danno 
un'impressione di scarsa professionalità agli utenti di un ambiente di lavoro. 
I-i cattura degli errori consente di intercettare gli errori quando si verificano, celan- 
done la visualizzazione agli utenti. Se l'errore può essere con-etto, ciò in genere av- 
viene (all'insaputa dell'utente) e l'esecuzione dello script può proseguire. Se l'errore, 
e più grave e non può essere corretto, è possibile visualizzare un messaggio nel 
browser per spiegare che cosa è accaduto e l'esecuzione dello script viene interrot- 
ta. PHP supporta tre diversi lipi di errore che differiscono nel livello di gravità. La 
Tabella 24.1 riporta queste ire ilpi ,1, v \ v <• fornisce esempi di ciò che potrebbe deter- 
minarle. 
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Tabella 24.1 Tipi di errore 



Tipo di errore 



Descrizione 



Notice 



Warning 



Fatai error 



Gli avvisi di tipo "Notice" sono generati quando uno fff «f 
«ulto In genere .sono di scarso rilievo (ossia I Interprete PHP e in gia- 
do di indovinare ciò che il programmatore intendeva e pertanto 1 ese- 
cuzione dello script prosegue). Per esempio, un avviso di questo tipo 
verrebbe generato se utilizzaste una variabile senza prima 
inizializzarla, 

I messaggi di attenzione "Warning" sono più seri, poiché 1 interprete 
non è in grado di risolvere il problema; tuttavia l'esecuzione dello 
script può comunque continuare. Per esempio, potreste ottenere ^un 
messaggio di questo tipo se cercaste di includere un file che non 
esiste. , 
Gli errori irreversibili (Fatai error) sono i più gravi. Quando vengono 
rilevati, l'interprete non è in grado di continuare ese cuzione elo 
script viene bloccato. Un errore di questo tipo si verificherebbe se cer- 
caste di chiamare una funzione che non è stata dichiarata. 



Ciascuno di questi tre tipi di errore può essere generato in diversi momenti da parte 
di componenti differenti del motore di sviluppo di PHP. Possono essere generati 
all'avvio del motore PHP, in fase di analisi, in fase di compilatone o durante 1 ese- 
cuzione dello script. Possono essere prodotti dal nucleo fondamentale del motore 
di PHP dalla libreria di funzioni che racchiude questo nucleo o dallo script applica- 
tivo Tutte queste combinazioni producono la definizione di undici diversi tipi di er- 
rore, ciascuno dei quali è definito da un valore numerico e da una costante con no- 
me; la Tabella 24.2 ne riporta un elenco. 



Tabella 24.2 Valori di errore, costanti e descrizioni 



Valore 


Costante 


Descrizione 


1 


E_ERR0R 


Errore irreversibile in esecuzione. 


% 1 


E_WARNING 


Messaggio "Warning" per un errore non irrever- 
sibile in esecuzione. 


4 


E PARSE 


Errori di analisi in compilazione. 


8 


E_N0TICE 


Avvisi in esecuzione (non gravi come i messaggi 






"Warning"). 

Errori irreversibili all'avvio. 


16 


E_C0RE_ERR0R 




E_CORE_WARNING 


Messaggio "Warning" per un errore non irrever- 


32 




sibile all'avvio. 


64 


E C0MPILE_ERR0R 


Errore irreversibile in compilazione. 


128 


E_COMPILE_WARNING 


Messaggio "Warning" per un errore non irrever- 
sibile in compilazione. 


256 


E USER ERROR 


Messaggio di errore generato dall'utente. 


512 


E_USER_WARNING 


Messaggio "Warning" generato dall'utente. 


1024 


E_USER_N0T1CE 


Awisc > "Notice" generato dall'utente. 


2047 


E ALL 


Tutti i precedenti. 



Per U momento non preoccupatevi di questi tipi di errore (costanti e valori), poiché 
li esaminerete più avanti in questo capitolo. Per prima cosa verranno creati alcun, 
script che genereranno i diversi messaggi di errore per vedere come appaiono. 



Esempi di Notice, Warning ed Error 




echo( "Esecuzione ancora in corso. <br>") 

H 

Lo script dichiara una variabile $var ma non le assegna alcun valore. Lo script ge- 
nererà il messaggio seguente nel browser: 

Notice: Undefined variable: var in 
c:\inetpub\wwwroot\phpbook\esempio24-1.php on line 6 
Esecuzione ancora in corso. 

Osservate che il messaggio informa del tipo di errore e comunica il nome dello 
script in cui esso si è verificato e la riga alla quale è stato rilevato. Come potete ve- 
dere, l'esecuzione dello script prosegue, in quanto il testo "Esecuzione ancora in 
corso" viene visualizzato dallo script dopo il rilevamento dell'errore. 
Consideriamo ora uno script che genererà un messaggio "Warning" più serio: 

<?php 

// Gestione errori - Esempio 24-2 

include ( " nonesiste . php" ) ; 

echo( "Esecuzione ancora in corso. <br>" ) ; 

■ 

Lo script tenta di includere un file "nonesiste.php" che in questo caso non esiste. 
Per questo motivo lo script genera il messaggio "Warning" che segue: 

Warning: main(nonesiste.php) : failed to open stream: No such 

file or directory in c:\inetpub\wwwroot\phpbook\esempio24-2.php on 

line 6 

Warning: main(): Failed opening 'nonesiste.php' for inclusion 
(include_path=' . ;c:\php\includes' ) in 
c:\inetpub\wwwroot\phpbook\esempio24-2.php on line 6 
Esecuzione ancora in corso. 

Ancora una volta, osservili»- clic il messaggio di errore segnala il tipo di errore, il 
nome dello script in cui <••••.< . si »• wi il'ii alo e la riga alla quale è stato rilevato. Anche 

In questo caso il Icsio "l\r« ii/loiu u ;i in corso." dimostra che l'esecuzione dello 

si ript prosegue. 
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L'ultimo script di questo paragrafo produce la forma più >:< - ' < un messa 8" 

gio "Fatai error": 

<?php 

■ 

// Gestione errori - Esempio 24-3 

// 

ball(); . iiasvi:: 

echo( "Esecuzione ancora in corso. <br> ), 

?> 

Lo script provoca un errore irreversibile tentando di chiamare una f^pgche non 
è S 2S Sita. Lo script determina la visualizzazione del messaggio seguente. 

Fatai error: Cali to undefined function: ball() in 
c'\inetpub\wwwroot\phpbook\eseitipio24-3.php on une t> 

alcun testo "Esecuzione ancora in corso . 

Regolazione della segnalazione degli errori 

Finora avete visto l'output di segnalazione di errore standard generato automatìca- 
men e dl pHP quando vengonc .rilevati diversi tipi di errori PHP consente pero di 
Sere quali dei tre livelli di errore vengono riportati e quali invece vengono em- 
pfceStnorati. La funzione error_reporting( ) consente di spostare ri li- 
vello" conente di segnalazione degli errori. 
La sintassi della funzione è la seguente. 

int error_reporting(int livello); 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


livello 

Restituzione di error_reporting ( ) 


int 
int 


Livello di segnalazione degli errori. 
Restituisce il livello di segnalazione. 


Esempio di funzione: 






error_reporting() 





Bis 

alla funzione. 



Tabella 24.3 Esempi di utilizzo della funzione error_reporting() 



Esempio 



Descrizione 



Grror_reporting(0) 

error_reporting(2047) 

error_reporting(E_ALL) 

error_reporting(3) 

error_reporting(E_ERROR | E_WARNING) 



Non verrà segnalato alcun errore. 
Verranno segnalati tutti gli errori. 
Verranno segnalati tutti gli errori (uguale 
all'esempio precedente). 
Verranno segnalati solo gli errori E_ERROR e 

F WARNTMft 



EJVARNING. 
Verranno segnalati solo gli errori E__ERR0R c 
E_WARNING (uguale all'esempio precedente). 



La funzione error_reporting ( ) restituisce un valore intero che corrisponde al li- 
vello corrente di impostazione della segnalazione di errori. Potete verificare il livel- 
lo di impostazione corrente chiamando la funzione senza alcun parametro: 



<?php 

// Gestione errori - Esempio 24-4 

K 



ocho ("Il valore di segnalazione i 
orror_reporting{ ) ) ; 

?> 



e di errori corrente è » . 



L'output di questo script è illustrato nella Figura 24.1. 



■ 



]lhttp://localhost/phpbook/esempio24-4.| 




Figura 24. 

Livello di segnalazione degli errori. 

Il valore 2047 significa che questo script visualizzerà tutti gli errori, a prescindere 
dalla loro gravità. Durante lo sviluppo degli script si consiglia di mantenere al livello 
massimo la segnalazione degli errori, in quanto ciò contribuirà a dar vita a script 
contenenti il minor numero possibile di errori. 



Operatore @ 

A questo punto vale la pena segnalare che PHP supporta l'operatore @, che può es- 
sere utilizzato per disattivare selettivamente i messaggi di errore generati dalle chia- 
mate a funzione. Per esempio: 

<?php 

// Gestione errori - Esempio 24-5 

/ / 

@ball(); 

echo( "Esecuzione ancora in corso. <br>" ) ; 
?> 

L'output di questo script non genererà messaggi di errore di alcun tipo. L'errore, pe- 
rò viene pur sempre rilevato (la chiamata a una funzione che non è stata definita) 
e dato che si tratta di un errore irreversibile, l'esecuzione dello script termina e il 
messaggio "Esecuzione ancora in corso" non viene visualizzato. Se si rimuove 1" ope- 
ratore @ l'errore irreversibile verrà nuovamente segnalato, Ma perché mai dovreste 
voler celare i messaggi di errore generati dalla chiamata a una funzione? Spesso le 
funzioni sono scritte da altri sviluppatori e il loro riutilizzo con il permesso degli au- 
tori è un'ottima pratica di programmazione; tuttavia, dato che potreste non poter ac- 
cedere al nucleo di codice della funzione, nel caso in cui si verifichi un errore, 1 uni- 
co modo per nasconderlo è ricorrere all'operatore @. 

Creazione di un proprio gestore di errori 

Finora abbiamo visto che PHP è dotato di un gestore di errori incorporato e che è 
possibile regolare il livello di segnalazione. Ma la cosa non finisce qui, perche e an- 
che possibile creare un proprio gestore di errori personalizzato, che consente di de- 
cidere come vengono visualizzati i diversi errori (ammesso che si decida di visualiz- 
zarli). La creazione dei gestori di errore personalizzati avviene con la funzione 
set_error_handler ( ) . 
La sintassi della funzione è la seguente. 

String Set_Error_handler( string gestoreErrori) ; 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


gestoreErrori 


string 


Il nome della funzione da chiamare quando si 






verifica un errore. 


Restituzione di 


string 


La stringa "True" se la l'unzione viene eseguita 


set_error_handler() 




correttamente, "False" In caso di problemi. 



Alla funzione set_error_handler ( ) viene fornito un valore che è il nome di 
una funzione chfl verrà chiamata nel caso in cui si verlllchl un errore. Questa 



funzione dev'essere scritta in modo che accetti i parametri riportati nella tabella 
seguente. 



Nome 

— ~ 


Tipo 


Descrizione 


cooe 


string 


U codice dell errore. 


message 


string 


Una descrizione dell'errore. 


f ilename 


string 


Lo script in cui Tenore si è verificato. 


lineNumber 


int 


Il numero di riga nello script in cui l'errore si è verificato. 


context 


array 


Un array che punta alla tabella dei simboli attiva nel 






punto in cui si è verificato l'errore. 



La funzione set_error_handler( ), inoltre, restituisce una stringa, che è la funzio- 
ne di gestione degli errori attualmente definita (se ne è stata definita una). Lo script 

C ' 1 < 1 1 I ■ - ■ » ? i • i ì i i 1 t r- 1 i 1 vi i' h l ' r . i i i * » I / i , I - ■ , r i i - . l \ . ... 



seguente illustra un esempio di utilizzo 
<?php 

// Gestione errori - Esempio 24- 
// 




■ 



set_error_handler( "errorHandler" ) ; 
include ( " nonesiste.php" ) ; 
function errorHandler ($code, $message, $f ilename, SlineNumberH 



echo( "<h2>Sfortunatamente si è verificato un errore</h2>" ) ; 

echo("Ecco le informazioni relative all' errore : <br><br>" ) ; 

echo( "Codice errore: $code<br>"); 

echo( "Messaggio di errore: $message<br>" ) ; 

echo{ "L'errore si è verificato nel file: $f ilename<br>" ) ; 

echoC'L'errore si è verificato alla riga: $lineNun,ber<br><< ) ; 



?> 



Lo script richiama la funzione set_error_handler( ) passandole il valore "er- 
rorHandler". La funzione errorHandler ( ) definita alla fine dello script si limita a 
visualizzare i valori passati alla funzione dal gestore di errori interno su righe sepa- 
rate. A metà dello script, una funzione include ( ) tenta di includere un file che non 
esiste, generando pertanto un messaggio d tipo "Warning". L'output generato da 
questo script è illustrato nella Figura 24.2. 

Benché la possibilità di creare proprie funzioni di errore personalizzate possa sembra- 
re una scusa per visualizzare l'errore in formati diversi rispetto al gestore di errore stan- 
dard, esistono altri motivi che possono spingere a crearne una. Per esempio si può de- 
cidere di porre termine allo script nel caso in cui vengano rilevati deteiminati errori. 



die ed exit 



Esistono due funzioni che ( onsentono di concludere uno script in un dato punto. 
Spesso queste l'unzioni v«-iijv .il. impupile quando viene rilevato un errore 'li tipo 
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Sfortunatamente si è verificato un errore 

Ecco le normazioni relative all'errore: 

Codice errore: 2 nT . 

Messaggio di errore: rnain(nonesiste.php): faded to open stream: No sud» file or directory 
L'errore si è verificato nel file: e:\inetpub\wwwrooftphpbook\esempto24-6.php 
L'errore si è verificato alla riga: 8 

Sfortunatamente si è verificato un errore 

Ecco le informazioni relative all'errore: 

SJaggTdTerrore: mainQ: Failed opening 'nonesiste.php' forinclusion (include_p a th='.x:\php4 

L'eJore si è verificato nel Se: e: \me^iib\wwwrootVhpbook\esernpio24-6.plip 
L'errore si è venficato alla riga: 8 



Figura 24.2 

Output del gestore di errori personalizzato. 



"Warning" o "Notice" e il programmatore non desidera che 1 esecuzione dello scnp 
prosegua, anche se l'interprete è in grado di farlo. 
La sintassi delle funzioni è riportata di seguito. 



void exit(void); 

void die(string messaggio); 



■ 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 


Tipo 


Descrizione 


messaggio 


string 


Messaggio da visualizzare prima della 






temiinazione. 


Restituzione di exit () e die ( ) 


void 


Non restituiscono alcunché. 


Esempio di funzione: 





■ 



die ("Lo script verrà terminato"); 



Entrambe le funzioni concludono uno script, ma 1, l»n/ <; d l o ( ) prl j™ y^alij 

/( .,ii un ,ur ,.,,,,o nel browser, Lo script scgu.-nic llluMr.. Unita) della funzione 



die( ). Lo scripi è uguale al precedente, con la differenza che ora, dopo la visualiz- 
zazione del messaggio di errore, lo script viene ultimato. 



<?php 



// Gestione errori - Esempio 24-7 

// V 



set_error_handler( "errorHandler" ) ; 



include( "nonesiste.php" ) ; 

■ 

function errorHandler ($code, $message, Sfilename, $lineNumber){ 

j 

echo( "<h2>Sf ortunatamente si è verificato un errore</h2>" ) ; 

echo("Ecco le informazioni relative all' errore:<br><br>" ) ; 

echo( "Codice errore: $code<br>"); 

echo( "Messaggio di errore: $message<br>" ) ; 

echo< "L' errore si è verificato nel file: $f ilename<br>" ) ; 

echo( "L'errore si è verificato alla riga: $lineNumber<br>" ) ; 

die ("Lo script verrà terminato"); 

Ovviamente questo script utilizzerà lo stesso stile di output per tutti i tipi di messag- 
gi di eirore. Esso inoltre terminerà lo script al rilevamento di qualunque tipo di erro- 
re. Tuttavia i gestori di errore personalizzati consentono di avere un maggiore con- 
trollo su ciò che avverrà in relazione al tipo di < 

Messaggi personalizzati 
diversi per i vari errori 

È pratica comune, tra i programmatori, creare funzioni di gestione degli errori per- 
sonalizzate che visualizzano diversi tipi e stili di messaggi in relazione al tipo di er- 
rore. Il gestore degli errori può anche essere utilizzato per porre termine a uno 
ript, ma solo in caso di rilevamento di determinati tipi di errore. Lo script di esem- 
pio che segue modifica la funzione errorHandler( ) per visualizzare diversi mes- 
saggi di errore per i tipi di errore E_NOTICE e EJWARNING. 

<?php 

// Gestione errori - Esempio 24-8 

set_error_handler ( "errorHandler" ) ; 
$a; 

include( "nonesiste.php" ) ; 



function errorHandler($codo, Smossage, Sfilename, $lineNumber){ 



switch(Scode) { 



case EJIOTICE: 

echo('<br><br>AVVISO: è stato rilevato un errore alla riga 

$lineNumber del file Sfilename"); 
echo("<br>Il messaggio di errore era Smessage"); 
break; 



case E_WARNING: 

echo( "<br><br>ATTENZIONE: è stato rilevato un errore alla riga 

$lineNumber del file Sfilename"); 
echo{"<br>Il messaggio di errore era Smessage"); 
break; 



} 



?> 



- 



Lo script utilizza un'istruzione switch per verificare se la variabile $code contiene i 
valori costanti E_WARNING e E_NOTICE; in relazione a ciò che viene rilevato, viene 
visualizzato un messaggio di errore diverso. Lo script genera messaggi di errore di 
tipo "Notice" e "Waming" e l'output generato è quello della Figura 24.3. 
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)hpbook/esempio24-8.php 



AVVISO: è stato rilevato un errore alla riga 8 del file c:\inetpub\wwwrootìphpbook\esempio24- 
8.php 

U messaggio di errore era Undefined variable: a 

ATTENZIONE: è stato rilevato un errore alla riga 9 del file 
e:Mnetpub\wwwroot\phpbook\esempio24-8.php 

E messaggio di errore era main(nonesiste.php): failed to open stream: No such file or directory 

ATTENZIONE: è stato rilevato un errore alla riga 9 del file 
e:\inelpub\vwwoot\phpbook\esempio24-8.php 

H messaggio di errore era main(): Failed opening 'nonesiste.php' for indusion 
(include_path='.;c:\php4\pear') 



; Intranet beale 



Figura 24.3 

Messaggi di errore personalizzati. 



Cattura dei tipi di errore 
E_PARSE ed E_ERROR 

Nell'esempio precedente avete visto che la funzione di gestione degli errori perso- 
nalizzata poteva catturare gli enori E_NOTICE ed EJVARNING. Non si è provato a 
catturare anche un messaggio di errore E_ERROR, operazione che verrà trattata in 
questo paragrafo. Lo script che segue è una modifica di quello precedente, ma ora 
la funzione di gestione degli errori è stata adattata in modo da visualizzare un mes- 
saggio di errore quando si imbatte in un errore E ERROR. 

<?php 

■ < 

// Gestione errori - Esempio 24-9 

■M$f'"'-.- 

set_error_handler( "errorHandler" ) ; 
$a; 

include ( " nonesiste . php" ) ; 
funt(); 

function errorHandler($code, $nessage, $filename, $lineNumber){ 
SW itch($code) { 
case E_NOTICE: 

echo("<br><br>AVVISO: è stato rilevato un errore alla riga 

$lineNumber del file $filename"); 
echo("<br>Il messaggio di errore era Smessage"); 
break; 

case E_WARNING: 

echo ( " <br><br>ATTENZIONE : è stato rilevato un errore alla riga 

$lineNumber del file Sfilename"); 
echo("<br>Il messaggio di errore era Smessage"); 
break; 

case E_ERROR : 

die("<br><br>ERRORE IRREVERSIBILE: alla riga SlineNumber del file 
Sfilename"); 

Mi ';<:"••,• 

W 



L'output di questo script è quello della Figura 24.4. 

Qui è importante osservare che il messaggio di errore irreversibile è stato rilevato,, 
ma non viene visualizzato il messaggio di errore definito nella funzione di gestione 
degli errori. Il motivo è che gli errori di tipo E_ERROR e E_PARSE vengono sempre 
gestiti dal gestore di errori incorporato in php, non da quello personalizzato. Que- 
sto vale anche se avete sellilo una funzione per la gestione di questo tipo di errori. 
In altre parole, la modìllia appi mala alla l'unzione di gestione degli errori nello 
script precedente è una |" ullla ili i. mpo 
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AVVISO: è stato rilevato un errore alla riga 8 del file e:\inetpubW-wwrooftphpbook\esempio24- 
9.php 

11 messaggio di errore era Undefined vanable: a 



ATTENZIONE: è stato rilevato un errore alla riga 9 del file 

e:\inetpubVw\vwroot\phpbook\esempio24-9.php ,. . ro 

faggio di errore era mam(nonesiste.php): failedto open stream: No suchfile or toctory 

'j 

ATTENZIONE: è stato rilevato un errore alla riga 9 del file 

e:\ketpub\wwwroot\phpbook\esempio24-9.php _ 

H messaggio di errore era mainO: Failed opening 'nonesiste.php forinclusion 

9.php online 10 



Figura 24.4 

Messaggio di errore E_ERROR. 



Innesco degli errori 



Oltre a creare una propria funzione per la gestione degli errori, PHP consente an- 
Se di inescare errori nello script, se lo si desidera. A tal fine è possale sceghere 
S duèSni; user_error() e trigger_error( ), che sono semplicemente 
alias una dell'altra. 

La sintassi delle funzioni è riportata di seguito. 

void' trigger error(string messaggio, [int Lxvello_errore] ) ; 
void user_er7or(string messaggio, [int Livello_errore]) ; 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



, ■ ~ —, 

Nome Tipo Descr.z.one 

mpssaooio strini Messaggio da visualizzare quando l'erro- 

mebùdyyj.o re viene innescato. 

i ì,p1 lo errore iht Valore di errore. 

Suzione di trigger_error() void Non restituiscono alcunché. 

e user_error() 



Esempio di funzione: 

trigger_orrorr81 è verificato un errore di tipo N«.uoo.<br>» ) ; 



Entrambe le hmZlonJ consentono di sollevare uno qualunque degli errori EJJSER, 
ossia E_USER_N0TICE, E_USER_WARNING e E_USER_ERROR; potete trovare i valori 
interi corrispondenti nella Tabella 24.2. Lo script che segue illustra l'innesco di 
ognuno di questi diversi tipi di errore. 

, 

<?php 

// Gestione errori - Esempio 24-10 

// 

trigger_error("Si è verificato un errore di tipo Notice.<br>" ) ; 
trigger_error( "<br>Si è verificato un errore di tipo Warning.<br>" , 
E_USER_WARNING) ; 

trigger_error("<br>Si è verificato un Fatai error.<br>", E_USER_ERROR) ; 

. 

echo("Fine del programma."); 

Lo script illustra che è possibile creare errori E_USER_NOTICE in due modi: si po- 
trebbe fornire alla funzione trigger_error ( ) un messaggio di errore insieme a 
una costante E_USER_NOTICE. L'alternativa, illustrata nello script, consiste nel forni- 
re alla funzione trigger_error ( ) soltanto un messaggio di errore, che automati- 
camente porterà alla creazione di un messaggio di livello E_USER_N0TICE, Per crea- 
re messaggi E_USER_WARNING ed E_USER_ERROR è necessario specificare il livello 
di errore come secondo parametro della funzione trigger_error(). L'output di 
questo script è quello della Figura 24.5. 
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Notice: Si è verificato un errore di tipo Notice. 
in e:\inetpub\wwwroot\phpbook\esempio24-10.php online 6 

Warning: 

Si è verificato un errore di tipo Warning. 
in e:\inetpub\wvuroot\phpbook\esempio24-10.php on line 8 

Fatai error: 

Si è verificato un Fatai error. 

in e:\inetpub\wwwroot\phpbook\esempio24-10.php online 10 



Jjjj Operazione comi 




Figura 24.5 

Innesco di errori E_USI-R. 



Nell'esempio precederne e il ncMttiv «li ni<>n im ■ n pi irato che gestisce gli errori inne- 
| .ni. Come è facile previ den I |XMM|1)ìI iibiiiiire l'innesco degli errori tramite la 



l'unzione error_trigger( ) con la gestione degli erimi |M-isoiullz/:ilii mediante la 
l'unzione errorHandler( ) . Lo script che segue illusila una Iiiii/m uh- di gestione degli 
errori in grado di elaborare errori di tipo E_USER_NOTICE ed E_USER_WARNING. 

<?php 

// Gestione errori - Esempio 24-11 

Il 

set_error_handler( "errorHandler" ) ; 

trigger_error("Si è verificato un errore di tipo Notice."); 
trigger_error("Si è verificato un errore di tipo Warning.", 

E_USER_WARN I NG ) ; 
trigger_error("Si è verificato un Fatai error.", E_USER_ERROR) ; 

echo("Fine del programma."); 

function errorHandler($code, $message, $filename, $lineNumber){ 
switch(Scode) { 

case E_USER_NOTICE: 

echo("<br><br>AVVISO: è stato rilevato un errore alla riga 

SlineNumber del file $filename"); 
echo("<br>Il messaggio di errore era $message"); 
break; 

case E_USER_WARNING : 

echo("<br><br>ATTENZIONE: è stato rilevato un errore alla riga 
SlineNumber del file $f ilename" ) ; 
echo("<br>Il messaggio di errore era $message"); 
break; 

case E_USER_ERROR: 

die("<br><br>ERRORE IRREVERSIBILE: alla riga SlineNumber del file 
$f ilename" ) ; 

} ' 

} 

?> 

L'output di questo script è quello della Figura 24.6. 

Vale la pena osservare che, proprio come nell'esempio di gestione degli errori pre- 
cedente (che aveva a che fare con errori generati dal sistema), qualunque errore ir- 
reversibile innescato verrà trattato dal gestore di errori interno, non dalla funzione 
di gestione degli errori personalizzata. 

Registrazione degli errori 

Invece di limitarvi a visualizzare il messaggio, potreste voler registrare da qualche 
parte che l'errore si è verificato. La registrazione degli errori in quelli che vengono 
definiti "file di registro degli errori" è una pratica molto diffUHB il registro degli erro- 
ri fornisci' una registrazione permanente degli errori c he si sonii verificati e di tutte 
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Il messaggio di errore era Si è verificato un errore di tipo Notice. 

ATTENZIONE: è stato rilevato un errore alla riga 10 del file 
e:\inetpub\wvnwoot\phpbook\esempio24-ll.php 
H messaggio di errore era Si è verificato un errore di tipo Warning. 

ERRORE IRREVERSIBILE: alla riga 12 del file 
e:\inetpub\wwwroot\phpbook\esempio24- 1 1 .php 

1 



Figura 24.6 

Innesco di errori mediante la gestione degli errori. 




le volte che lo script viene eseguito. PHP consente di registrare le informazioni rela- 
tive agli errori in un file di registro degli errori predefinito o in un file di vostra scel- 
ta; può persino inviare un messaggio contenente l'errore a un indirizzo di posta 
elettronica. Tutto ciò è possibile attraverso la funzione error_log ( ). 
La sintassi della funzione è la seguente. 

int error_log(string messaggio, int tipoMessaggio [, string destinazione 
[, string intestazioni]]); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 




Tipo 


Descrizione 


messaggio 

tipoMessaggio 

destinazione 

intestazioni 

Restituzione di error_log( ) 


string 

int 

string 

string 

int 


Messaggio da registrare nel registro degli errori. 
Dove registrare il messaggio di errore. 
Un indirizzo di posta elettronica cui inviare il 
messaggio di errore o un file locale cui ag- 
giungerlo. 

Facoltativo. Le intestazioni di posta elettronica 
che è possibile utilizzare sono descritte nel Ca- 
pitolo 21 in relazione alla funzione mail( ) . 
1 se la scrittura riesce, 0 in caso di errore. 



Esempio di funzione: 
er ror_log ( " Scode : Smontgo i \ ni f 




1-1 mi'Niinil)(!i-\n\n" ,3, "orrori o ( |" ) ; 



La funzione error_log( ) può assumere un numero variabile di parametri! da due in 
poi. Il primo parametro "messaggio" specifica il messaggio di errore. I tre restanti spe- 
cificano dove memorizzare o inviare il messaggio di errore'. Il parametro tipoMes- 
saggio viene utilizzato per specificare che tipo di memorizzazione si desidera. I valo- 
ri che è possibile specificare per tipoMessaggio sono elencati nella Tabella 24.4. 



Tabella 24.4 Tipi di error_log() 



Tipo di messaggio Descrizione 



0 II messaggio viene inviato al "system logger". Questo dev'essere attiva- 
to nel file php.ini, altrimenti l'output verrà inviato al browser. 

1 II messaggio viene inviato per posta elettronica all'indirizzo fornito nel 
parametro della destinazione. 

3 II messaggio viene aggiunto al file specificato come destinazione. 

Lo script che segue illustra l'utilizzo della funzione error_log( ) per memorizzare 
qualunque errore in un file di nome "errorLog": 

<?php 

// Gestione errori - Esempio 24-12 

//- ■ ------ 

set_error_handler( "errorHandler" ) ; 
$a; 

include ( 11 nonesiste . php" ) ; 

function errorHandler($code, $message, $filename, $lineNumber){ 

error_log("$code: $message: \n$f ilename, $lineNumber\n\n" ,3, "errorLog" ) ; 



?> 



Il file errorLog verrà salvato nella stessa director}' predefìnita dei file in cui si trovano 
gli script o, più esattamente, nella directory in cui lo script viene eseguito. La Figura 
24.7 illustra il contenuto del file errorLog dopo la prima esecuzione dello script. 



•fi?j errorLog - Blocco note 



p: undefined variatile: a: oe:\inetpub\wwroot\phpbook\esempio24-12. php, 80 D2 : 
main(nonesiste.php): fai 1 ed to open streara: No such file or directory: D 
e:\inetpub\wwroot\phpbook\esempio24-12.php, 90 02 : mainO: Fai 1 ed opening 
' nonesiste. php' for inclusion (1nc1ude_patn=' .; c:\php4 \pear'):o 



e:\inetpub\vrtjwroot\phpbook\esempio24-12. php, 900 



Figura 24.7 

Il file errorLog. 



bestione aegn errori ili 



Se avete accesso a un server di posta elettronica, potete inviare i messaggi di errore 
tramite e-mail, come illustrato nello script seguente: 

<?php 

// Gestione errori - Esempio 24-13 

set_error_handler( "errorHandler" ) ; 
$a; 

include ( " nonesiste . php" ) ; 

error_log ( " Scode : $message : \ n$f ilename , 

function errorHandler ($code, $message, $filename, SlineNumber) 
$lineNumber\n\n" ,1, "simon.stobart@sunderland.ac.uk"); 

Et ' - ' ' ''" ' 

Per poter inviare i messaggi di errore per posta elettronica sono necessari l'accesso 
a un server di posta elettronica e qualche modifica al file php.ini. La procedura da 
seguire è discussa nel Capitolo 21. 

; 

Riepilogo 

In questo capitolo è stato illustrato il concetto di gestione degli errori. Si è visto 
come il gestore di errori nativo di PHP possa catturare gli errori e come il program- 
ma possa creare funzioni di gestione degli errori personalizzate. Si è anche visto 
come sia possibile creare un registro per memorizzare in modo permanente gli er- 
rori che si verificano. Nel prossimo capitolo verrà esaminato il concetto di buffering 
dell'output, mettendo in luce come questa caratteristica possa essere di aiuto nella 
gestione degli errori. 



Capitolo 25 

Buffering dell'output 



Introduzione 

In genere gli script PHP inviano il proprio output direttamente alla periferica di out- 
I iui standard, che di solito è un browser Web. Tuttavia questa non è sempre la solu- 
1 /Jone migliore. Supponete, per esempio, che lo script rilevi la presenza di un errore 
dopo aver visualizzato parte di una pagina Web; anche se errori simili possono es- 
«cre corretti, come dimostrato nel capitolo precedente, il messaggio di errore po- 
ii ebbe apparire poco professionale, poiché una parte dell'output è già stata inviata 
ili browser. Questo capitolo introdurrà il concetto di buffering, che permette di me- 
morizzare tutto l'output generato dallo script e manipolarlo a proprio piacimento. 



Tutto bene finché non si scopre un errore 

Lo script riportato di seguito visualizza un'intestazione e il testo di una pagina Web. 
fi stata definita una funzione per la gestione degli errori, che cattura qualunque er- 
lore. 

<?ph P 

// Buffering dell'output - Esempio 25-1 

iet_error_handler("catchError") ; 
echo("<h1>Benvenuti nel mondo del buffering. </h1>") ; 

•cho("Il buffering è utile per evitare la visualizzazione parziale di una 
pagina Web nel caso in cui si verifichi un errore."); 

function catchError() { 

echo("<br>Sfortunatamente si è verificato un errore!."); 

) 

?> 
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In questo script non ci sono errori quindi, per mostrine cosn invade quando se ne 
scopre uno, è necessario introdurlo. 

<?php 

// Buff ering dell'output - Esempio 25-2 
//-- 

set_error_handler( "catchError") ; 

echo( "<h1>Benvenuti nel mondo del buffering.</h1>") ; 

echo( "Il buff ering è utile per evitare la visualizzazione parziale di una 

pagina Web nel caso in cui si verifichi un errore."); 
echo($doesnotexist) ; 

function catchError() { 

echo( "<br>Sfortunatamente si è verificato un errore!"); 

} 




Nello script, un'istruzione echo cerca di visualizzare una variabile inesistente, geni' 
rancio così un errore. Quando compare l'errore, la funzione catchError( ) viene 
invocata e compare il messaggio d'errore appropriato. L'output ottenuto da questo 
script è quello della Figura 25.1. 
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Benvenuti nel mondo del buffering. 

H buffering è utile per evitare la visualizzazione parziale di una pagina "Web nel caso in cui si verifichi un errore. 
Sfortunatamente si è verificato un errore I 



. i 

' zi 

"J§"Ópera?ione completata ^^^^^^ , \ . f~ 1 UÈ Intranet tocala ; 

Figura 25.1 

Messaggio d'errore visualizzato con altri testi. 

La Figura 25.1 mostra che è stato catturato l'errore e visualizzato il messaggio re- 
lativo. 

Compare anche l'output inviato al browser prima del rilevamento dell'errore. Ov- 
viamente questa è una situazione indesiderabile, Per fortuna PHP permette di con- 
trollare l'output intraverso il buffering e, in tal modo, consente ili scegliere quali in- 
formazioni inviare all'Utente. 



Buffering dell'output 

La funzione ob_start ( ) serve per attivare il buffering dell'output. Quando il buffer 
1 stato attivato, lo script non invia alcun output al browser, ma lo conserva in un 
buffer interno. 

La sintassi della funzione è la seguente. 
Void ob_start( [string funz]) 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


funz 


string 


Invocazione della funzione facoltativa. 


Restituzione di ob_start( ) 


void 


Non restituisce alcunché. 



La funzione ob_start ( ) può accettare un nome di funzione facoltativo per invoca- 
le l'avvio del buffering. Più avanti in questo capitolo sarà spiegato come utilizzare 
questo meccanismo. 

L'output viene memorizzato nel buffer e sullo schermo non compare alcunché fino 
all'invocazione della funzione ob_end_f lush( ), che invierà il contenuto del buffer 
ni browser. 

La sintassi della funzione è la seguente, 
void ob_end_f lush(void) ; 

La funzione non richiede parametri e non restituisce alcunché. Dopo che il conte- 
nuto è stato inviato al browser, il buffering dell'output viene disattivato. Infine, pri- 
llili di analizzare un esempio dell'utilizzo di queste funzioni, occorre introdurre 
Un'altra funzione: ob_clean ( ) . 
La sintassi della funzione è la seguente. 

Void ob_clean(void) ; 

'.mesta funzione cancella tutti i dati contenuti nel buffer di output. Anche questa 
funzione non richiede parametri e non visualizza alcunché. Considerate un esempio 
In cui si utilizza il buffering. Nello script seguente, si attiva un buffer e si registra 
una funzione per la gestione degli errori: 

<?php 

// Buffering dell'output - Esempio 25-3 

B>- 

ob_start( ) ; 

aet_error_handler( "catchError" ) ; 

ocho( "<h1>Benvenuti nel mondo del buffering. </h1>") ; 

«cho("Il buffering è utile per evitare la visualizzazione parziale di una 
pagina Web nel caso in cui si verifichi un errore."); 

echo($doesnotexist) ; 
ob_end_flush( ) ; 



function catchError ( ) { 
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} 

?> 



ob_clean() ; 

echo("<br>Sfortunatamente si è verificato un errerei"); 



L'output dello script è memorizzato nel buffer. La funzione ob_end_f lush( ) del 
buffer, tuttavia, non viene mai raggiunta, poiché nella riga precedente c'è un errore 
che comporta l'attivazione della funzione catchError ( ), che cancella il contenuto 
del buffer e visualizza un messaggio d'errore. L'output prodotto da questo script è 
quello della Figura 25.2. 



jjhttp://'localhost/phpbook/esempio25-3.php - Microsoft Internet Explorer 




Figura 25.2 

Solo un messaggio d'errore. 



La Figura 25.2 mostra che, anche se lo script ha prodotto output, è stato possibile 

ser. 



intercettarlo, cancellarle 

Accesso al contenuto 



Potreste comunque voler accedere e visualizzare il contenuto del buffer, operazio- 
ne possibilile tramite la funzióne ob_get_contents( ). 
La sintassi,della funzione è la seguente. 

String ob_get_contents(void) ; 

La tabella seguente descrive il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


Restituzione di 


string 


La funzione restituisce il contenuto del buffer 


ob_get_contents( ) 




sotto forma di stringa. 








Esempio eli funzione: 







$out = ob_oet_oontonts() ; 



buttering dell output ma 



Lo script che segue c una \ arianle di ciucilo precedente e mostra che è possibile ac- 
cedere e visualizzare il contenuto del buffer prima di cancellarlo. 

<?php 

// Buffering dell'output - Esempio 25-4 

// - 



ob_start(); 

set_error_handler( "catchError") ; 
echo("<h1>Benvenuti nel mondo del buffering.</h1>" ) ; 

echoC'Il buffering è utile - ~ '« Hl " iri 

pagina Web nel caso ì 



echo($doesnotexist) ; 
ob_end_flush() ; 



ile per evitare la visualizzazione parziale di una 
so in cui si verifichi un errore."); 



function catchError () { 
$out = ob_get_contents() ; 
ob clean( ) ; 



echo("<br>Sfortunatamente si è verificato un errore !<br>" ) ; 
echo("È stato visualizzato '$out"'); 



.Jl'interno della funzione catchError ( ) viene invocata la funzione ob_get_- 
contents<), che memorizza il contenuto del buffer nella variabile $out. Questo 
contenuto verrà poi visualizzato. L'Output di questo script è quello della Figura 25-3- 
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Sfortunatamente si e verificato un errore I 
E stato visualizzato 1 

Benvenuti nel mondo del buffering. 

É buffering è utile per evitare la visualizzazione parziale di una pagina Web nel caso in cui 
si verifichi un errore.' 



Operazione c 
Figura 25.3 

Visualizzazione dell'output dol bufhf . 




loo capitolo /3 



La Figura 25.3 mostra Che l'output preso dal buffer viene visualizzato dopo il mes- 
saggio d'errore. 

Non è detto che questo possa essere particolarmente utile, tuttavia se potete acce- 
dere al contenuto del buffer, potete anche modificarlo. ' 

Modifica dell'output 

Lo script seguente mostra che la funzione ob_get_contents ( ) permette di acce- 
dere al contenuto del buffer e modificarlo. 

<?php 

// Buffei-ing dell'output - Esempio 25-5 

" 

ob start () : 

set_error_handler< "catchError" ) ; 

echo( "<h1>Benvenuti nel mondo del buff ering. </h1>" ) ; 

echo("Il buffering è utile per evitare la visualizzazione parziale di una 
pagina Web nel caso in cui si verifichi un errore."); 

echo($doesnotexist); 
ob_end_f lush( ) ; 

function catchError() { 
$out = ob_get_contents() ; 
ob_clean() ; 

$out = str_replace( "nel mondo", "nell'universo", $out); 
echo("$out"); 

m 

7> 

Questa volta la funzione catchError () invoca la funzione ob_get_contents( ) 
per ottenere il contenuto del buffer, memorizzato nella variabile $out, che viene 
cancellato; è quindi utilizzata la funzione str_replace( ) per sostituire qualsiasi 
occorrenza di "nel mondo" con "nell'universo" presente nella variabile $out, che 
verrà visualizzata. L'output ottenuto dallo script è illustrato nella Figura 25.4. 
Sebbene questo esempio mostri che è possibile modificare il contenuto del buffer, 
lo abbiamo fatto con una funzione per la gestione degli errori. Esiste un metodo per 
intercettare il contenuto del buffer prima che sia visualizzato e anche se non si veri- 
fica alcun errore. 

Funzioni di callback 

La funzione ob_start() può accettare un parametro che rappresenta il nome di 
una funzipne invocata appena prima della funzione ob_end_f lush( ). 



fa 



r 
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Benvenuti nell'universo del buffering. 

Il buffering è utile per evitare la visualizzazione parziale di una pagina Web nel caso in cui 
si verifichi un errore. 



Figura 25.4 

Modifica del contenuto del buffer. 



La funzione invocata è nota con il nome di funzione di callback. Lo script seguente 
mostra l'esempio di una funzione simile. 

<?php 

// Buffering dell'output - Esempio 25-6 
Il 



ob_start("callBack"); 



<h1>Tutto a X euro</h1> 

Siamo lieti di presentarvi il nostro ultimo prodotto. Per soli X euro al 
mese potete avere 

■ 

<?php 

IL, ■ 

ob_end_flush() ; 

function callBack (Sbuffer) { 

return str_replace( "X" , "19,99", Sbuffer); 

Wa ,. 
?> 

La funzione, cui è stai. i assonnai. > il ■•< >me eli callBack (), deve essere in grado di rice- 
vere una stringa i ln- u> '•> a millennio del buffer. Inoltre dovrà restituire tale 

stringa in modo clic II mi lei luillci |iossa essere visualizzato nel browser. 

All'interno della lun/loni • |*i INI» modllìcilrc il contenuto della siringa, come 
nell'esempio prece. leni. I .»H| ««'imiim .l.t questo salpi è quello della Figura 25.5. 
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Indirizzo http:Wlocalhostyphpbookyesempio25-6.php 



~ J*1 jfv*Vai ! Collegamenti 



Tutto a 19,99 euro 



Siamo lieti di presentarvi i] nostro ultimo prodotto. Per soli 19,99 euro al mese potete 
avere .... 




Figura 25.5 

Modifica del contenuto di un buffer. 




Compressione dell'output del buffer 

Se nel leggere questo capitolo avete pensato che il buffer non possa esservi molto 
utile, considerate la funzione ob_gzhandler ( ) . 
La sintassi della funzione è la seguente. 

String ob_gzhandler (string buffer) 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 

_ 


buffer 


string 


Contenuto del buffer. 


Restituzione di ob_gzhandler( ) 


string 


Restituzione dell'output. 



Questa funzione è progettata per essere una funzione di callback della funzione 
ob_start ( ). Essa riceve il contenuto del buffer e, se il browser Web è in grado di 
accettare pagine gz_encoded, per esempio pagine Web compresse, il contenuto 
del buffer viene compresso e inviato al browser. 

Grazie a questa funzione, la velocità di trasmissione del sito Web aumenta e con 
essa aumenta anche la velocità di visualizzazione delle pagine Web. Di seguito è ri- 
portato un esempio dell'utilizzo di questa funzione in uno script. 

<?php 



// Buffering dell'output - Esempio 25-7 

// 



ob start ("ob Q/hnndler") ; 



?> 



<h1>Pagina Web rapida</h1> 

Questa pagina sarà compressa e inviata al browser se guest ultimo supporta 
la compressione. 



<?php 

ob_end_f lush() ; 

|?> 



Riepi 



Questo capitolo ha introdotto il concetto di buffering e ha mostrato a procedura da 
seguire per memorizzare in un buffer l'output degli script prima di visualizzarlo. 
Abbiamo spiegato come accedere, cancellare e, se necessario, modificare il conte- 
nuto del buffer. Abbiamo concluso introducendo il concetto di funzioni di callback 
e in particolare, ci siamo occupati della funzione ob_gzhandler ( ), che può velo- 
cizzare gli accessi alle pagine Web. Il prossimo capitolo analizzerà il ruolo dei file in 
PHP e mostrerà come crearli e manipolarli. 



Parte VII 

Gestione dei file 

I 

26 Lettura e scrittura su file 

27 Altre informazioni sulla gestione dei file 

28 Caricamento di file tramite i moduli 




Capitolo 26 

Lettura e scrittura su file 



i 



-, 

In questo capitolo si vedrà come leggere dati da file e scrivere informazioni su di es- 
si. In termini fisici, un file è una collezione sequenziale di caratteri che possono es- 
sere manipolati. In termini logici, un file può essere visto come una collezione di re- 
cord di dati oppure come un programma per computer. Molti sistemi informatici 





pertura di un file 

PHP può aprire un file ricorrendo a una funzione molto semplice, denominata 
f open ( ) . La sintassi della funzione è la seguente. 

int fopen (string nomefile, string modalità); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 



Tipo 



Descrizione 



so completo. 

teli --Salfilé 



nomefile 
modalità 



Restituzione eli 
f nnnn ( \ 



LM 



ìj 



Il nome del file e il sue 
" r " apre in sola 
zio del file. 

"r+" apre in lettura e scrittura; colloca il puntatore al fi- 
le all'inizio del file. 

"w" apre in sola scrittura; colloca il puntatore al file 
all'inizio del file e tronca il file alla lunghezza zero. Se il 
file non esiste, tenta di crearlo. 

"w+" apre in lettura e scrittura; colloca il puntatore al fi- 
le all'inizio del file e tronca il file alla lunghezza zero. Se 
il l'ile non esiste, tenta di crearlo. 

" a " apre in sola scrittura; colloca il puntatore al file alla 
in ir del l'ilo. Se il l'ile non esiste, tenta di crearlo. 

apre In lettura e scrittura; colloca il puntatore al fi- 
I. ili .1 in» ,li -I hi,- Se- il l'ile non esiste, tenta di crearlo. 

Unni orini mlonc Ntream al file specificalo. 



*v *• v-apitoio zo 



La tabella precedente illusila le varie modalità in cui e p<>,v.il>ilo aprirò un file. 
Esempi di funzioni: 

$fp = fopen ( "/home/book/f ile. txt " , "r" ) ; > 

$fp = fopen ( "/home/book/f ile. gif " , "wb"); 

$fp = fopen ( "http: //w«iw. example.com/file. txt" , "r+"); 

$fp = fopen ("ftp://user:password@example.com/file.txt" , "w"); 

PHP consente di aprire un file sulla macchina locale, nonché su un computer re- 
moto (se le autorizzazioni di protezione lo consentono). L'accesso ai file remoti 
può avvenire con una connessione HTTP o FTP. Se il nome del file inizia con 
http://, viene aperta una connessione HTTP con il server specificato e viene re- 
stituito un puntatore al file richiesto, Se il nome del file inizia con ftp://, viene 
aperta una connessione FTP con il server specificato e viene restituito un punta- 
tore al file richiesto. 

Se il nome del file inizia con qualunque altra cosa, esso verrà aperto dal sistema lo- 
cale e verrà restituito un puntatore al file richiesto. Se la funzione fallisce, viene re- 
stituito FALSE. I file possono essere aperti in molte moc 



possono essere aperti in molte modalità diverse in relazione a 

ciò che volete farne. 

Chiusura di un file 

Una volta ultimato l'accesso a un file, dovete chiuderlo per liberare la memoria e in- 




a un file aperto con fopen ( ) , 

La sintassi della funzione è la seguente. 



bool foiose (int puntatoreAFile) ; 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


puntatoreAFile 

Restituzione di 
fclose() 


int 

boolean 


Il puntatore a file prodotto da fopen ( ) . 

TRUE in caso di successo e FALSE in caso contrario. 


Esempio di funzic 


■ne: 




$fp = fopen ("/h 


iome/book/f 


ile. txt", "r"); fclose($fp); 



Ottenere la dimensione di un file 

La dimensione di un file in byte è un'informazione che può essere ottenuta facil- 
mente con la funzione f ilesize ( ) . 
La sintassi della l'unzione è la seguente. 

int filesize («trino nomefile); 



Lettura e scrittura su tue 



La tabella seguente dosi rivo l'argomento e il tipo di valore restituito dalla fun- 



zione. 






Nome 


Tipo 


Descrizione 


nomefile 

Restituzione di filesize() 


string 
int 


Il file da utilizzare e il suo percorso completo. 
Restituisce la dimensione del file in byte. 


Esempio di funzione: 






$bytes = filesize (Sfile 


name); 


• 



Questa funzione non è utilizzabile con i file remoti e il file da esaminare dev'essere 
accessibile attraverso il filesystem del server. 

Lettura di un intero file 

Dopo aver aperto un file è possibile leggerne il contenuto in tutto o in parte. Per 
leggere l'intero file (dall'inizio alla fine), è possibile utilizzare la funzione 
fread(). 

La sintassi della funzione è la segi. 



string fread (int puntatoreAFile, int lunghezza); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun- 



Nome Tipo Descrizione 



puntatoreAFile int II puntatore a file prodotto da fopen ( ) . 

lunghezza int La dimensione totale del file. 

Restituzione di fread ( ) string Intero file come testo in una stringa. 

— — 

Esempi di funzioni: 

*,v...y, ; *«;•.?*■- 
$fp = fopen (Sfilename, "r"); 

Scontents = fread ($fp, filesize ($f ilename) ) ; 



Notate che è necessaria la funzione filesize ( ) per determinare la dimensione del 



file. 



Lettura di un intero file in una stringa 

Un'altra funzione che è possibile utilizzare per leggere il file intero è f ile_get_con- 
tents(). 

La sintassi della funziono ò la seguente. 

string f ile_get_contonti (Iti Lnfl immotile ); 
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La tabella seguente descrive l'argomento e il tipo di valori- r< stimilo dalla funzione. 



Nome 


Tipo 


Descrizione 


nomefile 


string 


Nome del file. 


Restituzione di 


string 


Contenuto del file. 


file_get_contents() 







Esempi di funzioni: 

$contents = f ile_get_contents ( "test .txt" ) ; 

Scontents = f ile_get_contents ("http://ivww.yahoo.com"); 

Con questa funzione, il contenuto del file viene collocato in una stringa. È possibile 
utilizzare un URL come nome del file con questa funzione se i wrapper fopen( ) 
sono stati attivati. Se un file è troppo grande, questa funzione non è adatta. 

Lettura di un intero file in un array 

Esiste una funzione chiamata file ( ) che viene utilizzata per leggere un intero file 
in un array, dove ogni elemento dell'array corrisponde a una riga nel file. Se il file e 
di dodici righe, l'array prodotto conterrà dodici elementi. 
La sintassi della funzione è la seguente. 

array file ( string nomefile ); 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 




Tipo 


i - 

Descrizione 


nomefile 


string 


Nome del file da utilizzare. 


Restituzione di f ile( ) 


array 


Inserisce il file in un array. 


Esempi di funzioni: 


• 




Sr.nntent = filef "test. txt" ) ; 




$line1 = $content[0]; 






$line2 = Scontentili; 







I 



Lettura di un carattere da un file 

La lettura dei caratteri da un file può avvenire con la funzione f getc( ) , che ha la 
sintassi seguente. 

string fgetc(int puntatoreAFile) ; 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome Tipo Descrizione 

puntatoreAFile int II puntatore a lìlc propalo du f open( ). 
n I, fnntr.M UHI Strlnu:. o .nini I Militilo fariniere letto dal «ile. 



Esempi di funzioni: 

$fp = fopen (Sfilename, "r"); 
Scharacter = fgetc(Sfp); 



■ 



La funzione richiede un solo parametro, il puntatore a file, che viene fornito dal- 
la funzione fopen (), e restituisce una stringa contenente un singolo carattere 
letto dal file. Lo script che segue visualizza il primo carattere del file test.txt, un 
semplice file di testo memorizzato nella sottodirectory files e contenente il se- 
guente testo: 

1. Sopra la panca la capra campa, sotto la panca la capra crepa. 

2. Sopra la panca la capra campa, sotto la panca la capra crepa. 

3. Sopra la panca la capra campa, sotto la panca la capra crepa. 

4. Sopra la panca la capra campa, sotto la panca la capra crepa. 



Questo script di esempio può essere utilizzato con c 
mo carattere. 

<?php 

■ 

// Lettura e scrittura su file - Esempio 26-1 

// -■■■ 

$fp1 = fopen("files/test.txt" , "r"); 
$c = fgetc($fp1); 



per rilevare il pri- 



echo("Il primo carattere è $c"); 
fclose{$f p1 ) ; 

H 



Lettura di un file una riga alla volta 



Oltre a leggere i singoli caratteri da un file, PHP supporta anche la lettura di un'inte- 
ra riga di caratteri. Questo è possibile grazie alla funzione f gets ( ) , che ha la sintas- 
si seguente. 



string fgets (int puntatoreAFile, int lunghezza) ; 

La tabella seguente descrive gli a — 
zione. 




ilore restituito dalla fun- 



Nome 



Tipo 



Descrizione 



puntatoreAFile 
lunghezza 

destituzione di fgets ( ) 



int II puntatore a file prodotto da fopen ( ) . 

int La dimensione totale del file. 

string Restituisce una stringa, che può essere al massi- 

mo di lunghezza -1 byte, letta dal file cui punta 
puntatoreAFile. 
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Esempi di l'unzioni: 

$s = fgets($fp1 , 4096); 



La funzione leggerà un certo numero di caratteri in una stringa fino al raggiungi- 
mento del valore lunghezza, alla lettura di un carattere newline o al raggiungimen- 



to "del marcatore di file del file. Per rilevare il marcatore di file del file è necessaria la 



funzione f eof ( ) . 
La sintassi della funzione è la sej 

int feof (int puntatoreAFile) ; 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


puntatoreAFile 
Restituzione di f eof ( ) 


int 
int 


Il puntatore a file prodotto da f open( ). 
Restituisce TRUE se è alla fine del file, altrimenti 
restituisce FALSE. 


Esempi di funzioni: 
$s = feof(Sfpi); 







Lo script che segue illustra un esempio di lettura di un file riga per riga. 
<?php 

// Lettura e scrittura su file - Esempio 26-2 
//--- 

$fp1 = fopen("files/test.txt" , "r"); 



echo("Il contenuto del file test.txt è:<p>"); 
echo("<form>") ; 

echo("<textarea cols=70 rows=15>"); 
$c=1; 

$s = fgets($fp1, 4096); 

whileflfeof ($fp1)) { 
echo("$c: $s"); 



$c++; 



$s = fgets($fp1, 4096); 
} 

echo( "</textarea></form>") ; 
foiose ($fp1); 

?> 



Lettura di un file remoto 

l.'upatura .li un l'ile remoto può avvenire con la si. • ■ ••■ Hll ' ili un file locale, pur- 
clu- si ili.soonua «Mie autorizzazioni necessari i ■ N»' 



Lettura e scrittura su me iyy 



cificare il nome di una pagina Web (che ovviamente è memorizzata come file), che 
viene poi letta e visualizzata in un campo textarea. 

<?php 

// Lettura e scrittura su file - Esempio 26-3 

if (isset($_POST[ 'webpage' ]) ) 

Swebpage = $_POST[ 'webpage 1 ] ; 

else 



Swebpage = " " ; 



cho "Inserire l'indirizzo della pagina Web http://"; 

echo "<form action='" . $_SERVER[ 'PHP_SELF' ] .'" method='post'>"; 

echo "<input type='text' size='30' name= 'webpage ' value=' Swebpage '>"; 

echo "<input type = 'submit' value= ' Visualizza '>" ; 

echo "</form>"; 

if (Swebpage) { 

$fp1 = fopen("http://" . $_P0ST[ 'webpage '], "r" ) ; 
echo "Il contenuto della pagina Web è:<p>"; 
echo "<form>"; 

echo "<textarea cols=70 rows=15>"; 
$c=1 ; 

Ss = fgets($fp1, 4096); 



while( Ifeof ($fp1 ) ) { 
echo "Ss"; 

Ss = fgets($fp1 , 4096) ; 

I 

echo "</textarea></form>" ; 
fclose(Sfpl) ; 



.'output di questo script è quello della Figura 26.1. 



3 littp:/7localhost./phpbook/esempio2ti-3.php - 



File Modifica Visualizza Preferiti Strumenti ? 



♦•Metro - - p. tS | ® Cerca Lij Preferiti ^Multimedia 0 ! %• & 
Indirizzo |f^) http://localho5t/phpbooWesempio26-3.prip 

Inserire l'indirizzo della pagina Web http:// 



HQ Operazione completata 



Figura 26.1 

Lettura di un file remoto. 



300 Ca pitolo 26 



Se viene fornito l'indirizzo di una pagina Web, il suo mille nnio vinte collocato in 
un campo textarea, come mostrato nella Figura 26.2. 



■j http:..yiocalhost/phpbook/eiempio26-3.plip - Microsoltjnternel Explorer 



File Modifica Vlsuataa Preferiti 
Indietro » -* ■ ® H) 



iii h^t* ? .„ _ JHI 



lhttp:/Jlocò!host/phpbooWesiirii^o26-3.prip _ 



Inserire l'indirizzo della pagina Web http:// 



|www.php.net Visualizze 
1 contenuto della pagina Web è: 




<!DOCTYPE HTML PUBLIC »-//H3C//DTI> HTHL 4.01 Transitional//EN"> 

<html> 

<head> 

<title>PHP: Hypertext Preprocessor</title> 

-slink rel="stylesheet" 
href = "http : // stat ic . php . nec/i 

<link rel="stylesheet" 
hre£="http://static. php. net/www. php.net/styles/phpnet.C3S" /> 

<link rel="shortcut icon" ' 
href = "http: //stat le. php.net/wMW.php.net/favioon. ico" /> 

<script language="Javascript" type="text/ Javascript" 
src="http : // static . php . net/ raraw . php . net/ userpref s . js"X/scr ipt> 



<foase href="http://www. php. net/index. php" /></head> 
<body bgcolor="#ffffff " text="#000000" 

link="#OO0Q99" alink="#0000f £" vi ink= "#000099" 




Figura 26.2 

Risultato della lettura di un file remoto. 



Scrittura su file 

Finora gli esempi hanno mostrato che i file possono essere letti e visualizzati. Tutta- 
via, gli strumenti di gestione dei file di PHP consentono anche di scrivere dati sui fi- 
le. La funzione f write ( ) consente di scrivere stringhe in un file. 
La sintassi della funzione è la seguente. 

int fwrite(int puntatore_a_file, string str, int lunghezza); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome Tipo Descrizione 

puntatore_a file int II puntalo»? n file prodotto da Topen ( ) . 

lunghezza int La dimensioni Mal. del (Ile che lejwe. 

KesWuzione eli f write ( ) int Numero .Il l.yi. ■ * tunnel llle. 



Lettura e scrittura su file 301 



Esempi di funzioni: 



$fp = fopen ($f ilename, "w"); 
$fw = fwrite ($fp, $content ); 



L'esempio che segue utilizza la funzione fopen ( ) per creare un file "test2.txt" (con 
l'opzione "w") e fwrite <) per scrivervi una stringa. Il nuovo file verrà creato nella 
directory files e deve avere le autorizzazioni corrette, in modo che PHP possa scri- 
vere in esso. 



<?php 



// Lettura e scrittura su file - Esempio 26-4 



$f ilename = "f iles/test2.txt" ; 

$content = "Ciao, questo è il mio file."; 

$fp = fopen ($f ilename, "w"); 

$fw = fwrite ($fp, $content); 

fclose($fp) ; 



?> 



- 



Esaminando il contenuto della directory /ì/es e visualizzando il file test2.txt si ottiene 
il file della Figura 26.3. 



'• test2.tnt - Blocco note 



File Modifica F 



Ciao, questo è 11 mio fi le. 




Figura 26.3 

Il file creato. 



Verifica dell'esistenza di un file 



Per verificare che un file esista si utilizza la funzione file_exists( ). 
La sintassi della funzione e la seminile 



Bool file_exists(8trlng noMTU»); 
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La tabella seguente descrive l'argomento e.il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


nome file 


string 


Nome del file. 


Restiaizione di f ile_exists( ) 


boolean 


Restituisce TRUE se il file esiste o FALSE 






in caso contrario. 


Esempio di funzione: 







$file = f ile_exists($f ilename) ; 

Realizzazione di un guestbook 

con le funzioni di manipolazione dei file 

Un'applicazione molto comune che sfrutta le funzioni di manipolazione dei file è il 
guestbook, una pagina utilizzata da molti siti Web per consentire agli utenti di la- 
sciare il proprio nome e qualche commento. Con le funzioni di lettura e scrittura è 
possibile rispettivamente leggere i messaggi memorizzati e scriverne di nuovi. 
L'esempio che segue introduce un modo rapido per implementare un'applicazione 
di questo tipo. 

<?php 

// Lettura e scrittura su file - Esempio 26-5 

// 

Sdatafile = "files/data.txt"; 

if ( isset ($_P0ST[ 1 submit ' ] ) ) { 

$name = $_P0ST[ 1 name 1 ] ; 
Scomments = $_P0ST[ 1 comments' ] ; 

$new_content = "Inaine: :$comments\n" ; 

$fp = f open (Sdataf ile, "a"); 
$fw = fwrite($fp, $new_content) ; 

j $f ° = fclose($fp); 
?> 

<html> 

<body bgcolor="#FFFFFF" text=" #000000 "> 
<b>GUESTB00K </b> 
<form name="form1" method="post" 

action="<?php echo $_SERVEB[ 'PHP_SELF' | ;?>"> 

<table width="30V border="0" cellspaci.ng,--0' col lpodding="0" 
height="50"> 



<tr> 

<td width="3lv>Nome:</td> 

<td width="69%"><input type="text" name="name"></td> 
</tr> 

<tr> 

<td width="31%">Comnenti:</td> 
<td width="69%"><textarea name="comments" 
rows="3"></textarea></td> 

</tr> 



</table> 



<input type="submit" name=" submit" value="lnvia commento"> 
<input type="reset" narae="Reset" value=" Reimposta 1 ^ 
<br> 

</form> 

<hr> 

<?php 

//Lettura di dati da un file e creazione di un ciclo per la 
//visualizzazione 

if (file_exists (Sdataf ile)) { 
$read_data = f ile($dataf ile) ; 
$num_comments = count($read_data) ; 

f or ( $c=0 ; $c<$num_comments - 1 ; $c++ ) { 

$content = explode( " : : " , $read_data[$c] ) ; 
echo "<b>Nome:</b> $content[0] " ; 
echo "<br>"; 

echo <b>Commento:</b> $content[1 ] " ; 
echo "<br><br>"; 



loro 



} 



} 



ir.?* 

<hr> 
</body> 
</html> 



La prima parte dello script elabora i dati del modulo e apre il file. 

«Sdatafile = "files/data.txt"; 

if( isset ($_P0ST[ 'submit' ])){ 

$name = $_P0ST[ 'name' ] ; 
Scomments = $_P0ST[ 'commenta' ) ; 

$new_content = "Sname: :$commonta\n" ; 

$fp = fopen( Sdataf il», 

Sfw fwri.to($lp, i. •, 

Sfc = fcl08e($fp); 



La parte successiva visuali/za il modulo: 



<html> 

<body bgcolor="#FFFFFF" text="#000000 > 
<b>GUESTBOOK </b> 
<form name="form1" method="post" 
action="<?php echo $_SERVERl' PHP_SELF' ] ;?>"> 

<table width="30%" border="0" cellspacing="0" cellpadding="0" 
height="50"> 

<tr> 

<td width="31%">Nome:</td> 

<td width="69%"><input type="text" name="name"></td> 
</tr> 

<tr> 

<td width="31%">Commenti:</td> 
<td widt h= " 69% " xtextare a name="comments" 
rows="3"></textarea></td> 

</tr> 
</table> 

<input type="submit" name="subniit" value="Invia commento"> 
<input type=" reset" name=" Reset" value=" Reimposta 1 ^ 
<br> 

</form> 
<hr> 

La parte finale verifica se il file esiste e visualizza il contenuto del guestbook: 



if (file_exists($datafile)) { 
$read_data = f ile($dataf ile) ; 
$num_comments = count(Sread_data) ; 

f or ( $c=0 ; $c<$num_comments - 1 ; $c++ ) { 

Scontent = explode( " : : " , $read_data[$c] ) ; 
echo "<b>Nome:</b> $content[0] " ; 
echo "<br>°; 

echo "<b>Commento:</b> $content[1 ] " ; 
echo "<br><br>"; 

ì 

La Figura 26.4 illustra l'output prodotto dallo script precedente. 



3| http://localhost/phpbook/esenipio2G-5.php - Microsoft Internet Explorer 



File Modifica Visualizza Preferiti Strumenti 



Indietro - *s ■■ [tf] | ^ Cerca [*g Preferiti f^Multii 



Indirizzo 



]http://localhost/phpbook/esempioZ6-5,php 



GUESTBOOK 



Nome: 
Commenti: 














Nome: Simon 
Commento: Ciao 

Nome: Simon 
Commento: Ciao 

Nome: Simon 
Commento: Test 



Figura 26.4 

Output del guestbook. 



Riepilogo 

Questo capitolo ha illustrato come compiere alcune semplici operazioni di manipo- 
lazione dei file. Sono state introdotte le funzioni che permettono di leggere e scrive- 
re su file esistenti o che devono essere creati. Il capitolo si è chiuso con la creazione 
di un semplice script per la realizzazione di un guestbook. Nel prossimo capitolo 
verranno esaminati in modo più approfondito alcuni altri strumenti di gestione dei 
file forniti da PHP. 



Capitolo 27 

Altre informazioni 
sulla gestione dei 



Introduzione 



Nel capitolo precedente è stato introdotto il concetto di file, spiegando come crear- 
ne uno e come scrivervi dati. Tuttavia, la gestione dei file non si limita alla semplice 
creazione e scrittura di dati. PHP offre alcune funzioni che permettono di utilizzare 
e manipolare i file già esistenti. Questo capitolo presenterà alcune di queste funzio- 
ni e ne mostrerà l'utilità. 



■ ■ 



Come ottenere il tipo di file 

Avete già avuto modo di vedere che PHP è in grado di aprire un file ricorrendo alla 
funzione fopen{). 

A volte può essere utile sapere se si ha a che fare con un file normale o una di- 
Bectory. PHP mette a disposizione due funzioni che aiutano a stabilire il tipo di file. 
La sintassi delle funzioni è riportata di seguito. 

bool is_file (string nomefile); 
bool is.dir (string nobile); 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalle funzioni. 



Nome 



~ Ti^ Descrizione 



nomefile string 
Restituzione di is_f ile ( ) boolean 
Restituzione di is_dir ( ) boolean 



Il nome del file e il relativo percorso di sistema 
completo. 

TRUE se il nome di file specificato esiste ed è un 
file normale. 

TRUE se il nome di file specificato esiste ed è una 
directory. 



taempi di funzioni: 

[icheckFile = is_filo ( ■ /homo/book/f ile.txt" ) ; 
ScheckDir = is_dir C/homo/bookr | ; 



300 capitolo li 



Queste funzioni non agiscono sui file remoti, quindi il n e di file da esaminare 

dev'essere accessibile munite il filesystem del server. I.o script che segue illustra 
l'utilizzo di queste funzioni, 



<?php 

// Gestione dei file - Esempio 27-1 

// 



$datafile = "f iles/data.txt" ; 



if (isset($_POST[ 'submit'])){ 

$filename = $_P0ST[ 'filename' ] ; 
if (is_file($filename)) 

echo "$filename è un file"; 
elseif (is_dir($filename)) 

echo "Sfilename è una directory"; 
else 

echo "Non so cosa sia Sfilename!', 
<html> 

<body bgcolor= " #FFFFFF " text=" #000008 "> 
<h2>Controllo dei file</h2> 

<form name=" formi" method="post" 
action="<?php echo $_SERVER[ 1 PHP_SELF' ] ;?>"> 

Nome del file:<input type="text" name="f ilename"> 

<input type="submit" name="submit" value=" Invia nome file > 

<in?ut type=»reset" name="Reset» value=» Reimposta "> 

</form> 



</body> 
</html> 

Lo script è costituito da due parti principali. La prima stabilisce se il modulo è stato 
inviato, poi accede al nome di file: 

Sdatafile = "f iles/data.txt" ; 

if (isset($_POST[ 'submit' ])){ 

Sfilename = $_P0ST[ 'filename 1 ] ; 

successivamente invoca le funzioni is_f ile ( ) e is_dir ( ) per stabilire se il file indi- 
cato è un file o una directory, ma può anche non riuscire a stabilire di che cosa si tratti: 

if (is_f ile (Sfilename)) 

echo "Sfilename è un file"; 
elseif (is_dir($filename)) 

echo "$fil«n«mt ò una directory"; 
else 

echo "Non ao coso sia Sfilename I ; 

} 



L'ultima parte dello script visualizza il modulo che l'utente utilizza per immettere il 
nome del file: 

<html> 

<body bgcolor="#FFFFFF" text=" #000000 "> 
<h2>Controllo dei file</h2> 



<form name="form1" method="post" 
action="<?php echo $_SERVER[ ' PHP_SELF' ] ;?>"> 

Nome del file:<input type="text" name="f ilename"> 
<input type="submit" name="submit" value="Invia nome file"> 
<input type="reset" name="Reset" value="Reimposta"> 



</f orm> 

</body> 
</html> 



ì 



L'output ottenuto da questo script è quello della Figura 27.1. 



3 littp://localhost/phpbook./esempio27-l.php - Microsoft Internet Explorer 



File Modfica Visualizza Preferiti Strumenti ? 



^-"Indietro - ■* •■ f|| [f] j 

Indirizzo jUj http://loca!host/phpbook/eser l )pio27- 1 . php 




esempio27-l.php è un file 

Controllo dei file 

Nome del file: 



Figura 27.1 

File e directory. 

Hill 



. ■ 



Dimensioni dei file 

Alcuni file possono raggiungere dimensioni notevoli, quindi è molto importante po- 
ter controllare la dimensione di un file prima di cominciare a utilizzarlo. Dal capito- 
lo precedente sappi. mi, . , hi è p, uwlhllc ricorrere alla funzione f ilesize( ) per de- 



J IU V_.ipiLOKJ /./ 



terminare la dimensione di un file. Di seguilo c riportai., un., nuova ve rsione dello 
script precedente clic \ isuallz/.u la dimensione del lile espressa in byte. 

<?php 

// Gestione dei file - Esempio 27-2 

// 

Sdatafile = "f iles/data.txt" ; 

if (isset($_POST[ ' submit' 1 ) ){ 

Sfilename = $_P0ST[ 'filename 1 ] ; 
if (is_file($f ilename)) { 

$bytes = filesize($filename) ; 

echo "$filename è un file di Sbytes byte.'; 

} 

else 

echo "Non so cosa sia $f ilename ! " ; 

} 

?> 

<html> 

<body bgcolor="#FFFFFF" text=" #000008 "> 
<h2>Controllo dei file</h2> 

„ ; 

<form name="form1 " metnod= post 
action="<?php echo $_SERVER[ ' PHP_SELF' ] ;?>"> 

Nome del file:<input type="text" name="f ilename "> 

<input type="submit" name=" submit" value="Invia nome file"> 

<input type=" reset" name="Reset" value="Reimposta"> 

</form> 

</body> 
</html> 

L'output ottenuto da questo script è quello della Figura 27.2. 



Statistiche relative al file 

Con le funzioni stat ( ) e lstat ( ) si possono ottenere ulteriori informazioni su un 
file. La differenza principale tra queste due funzioni è che, oltre alle informazioni 
sui file, lstat () è in grado di restituire anche informazioni sui collegamenti simbo- 
lici. Queste funzioni non agiscono sui file remoti o sulle cartelle locali, pertanto il 
file da esaminare dev'essere accessibile tramite il filesystem del server. 
La sintassi delle funzioni è riportata di seguito. 



array stat (string nomefile); 
array lstat (string nomefile); 



«aie miormazioni sulla gestione dei file 



a http:/ /lo calhost/phpbook/esenipio27-2.php - Microsoft Internet Explorer 



File Modifica Visualizza Preferiti Strumenti ? 




esempio27-2.php è un file di 719 byte. 

Controllo dei file 




Figura 27.2 

Dimensione del file espressa in byte. 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalle funzioni. 



Nome 



Tipo 



Descrizione 



nomefile 



string File da utilizzare e relativo percorso di sistema 

completo. 



Sstatistics 



Restituisce un array con le statistiche del file (se 
ne parlerà più avanti in questo capitolo). 
Restituzione di lstat ( ) array Restituisce un array con le statistiche del file o 
del collegamento simbolico. 

wfh. ;• „ 
Esempio di funzione: 

stat ($f ilename) , 

Queste funzioni raccolgono statistiche relative al file indicato da nomefile e resti- 
tuiscono un array contenente le statistiche del file/collegamento simbolico con gli 
elementi indicati di seguito. 

0. periferica [dev]; 

1. inode [ino]; 

2. modalità di protezione inode [mode ] ; 

3. numero di collegamenti [nlink]; 

4. ID utente del proprietario [uid] ; 

5. ID di gruppo del proprietario [gid]; 

6. tipo di periferica •.<• p.ul.iKa lumie [rdev] (valido solo sui sistemi che 
supportano il tipo «t J>1K|ÌM; K h alni sistemi (per esempio Windows) re- 
stituiscono 

7. dimensione In byte I olit|, 



8. ora dell'ultimo accesso [atime]; 

9. ora dell'ultima modifica [intime]; 

10. ora dell'ultimo cambiamento [ctime]; 

11. dimensione di blocco per l'I/O del file system [blksize] (valido solo sui 
sistemi che supportano il tipo st_blksize ; gli altri sistemi, per esempio 
Windows, restituiscono -1); 

12. numero di blocchi allocati [blocks]; 
Lo script che segue mostra l'utilizzo della funzione stat ( ) . 



<?php 

// Gestione dei file - Esempio 27-3 



li- 



$datafile = "f iles/data.txt" ; 
if ( isset ($_P0ST[ ' submit 1 ] ) ) { 

$filename = $_P0ST[ 'f ilename 1 ] ; 



if (is_file($f ilename)) { 
$stats = stat ($f ilename) ; 

echo "Statistiche relative al file $f ilename: " ; 
echo "<br>Perif erica " . $stats[ 1 dev 1 ] ; 
echobr>Inode " . $stats[ 1 ino 1 ] ; 

echo "<br>Modalità di protezione inode " . $stats[ 'mode' ] ; 
echo "<br>Numero di collegamenti " . $stats[ 1 nlink' ] ; 
echo "<br>ID utente del proprietario " . $stats[ 'uid' ] ; ^ 
"<br>ID di gruppo del proprietario " . $stats[ 'gid' ] ; 
"<br>Tipo di periferica se periferica inode " . $stats[ 



echo 
echo 
echo 
echo 
echo 
echo 



rdev 1 ] ; 



<br>Dimensione in byte * . $stats[ 1 size 1 1 ; 
<br>ora dell'ultimo accesso " . Sstats[ 'atime' ] ; 
<br>0ra dell'ultima modifica " . $stats[ 'mtime' ] ; 
<br>Ora dell'ultimo cambiamento " . Sstats[ ' ctime '] ; 
echo "<br>Dimensione di blocco per l'I/O del file 

system " .$stats[ ' blksize '] ; 
echo "<br>Numero di blocchi allocati " . Sstats[ 'blocks ' 1 ; 



else 



} 



echo "Non so cosa sia $f ilename is! 



?> . . ■■ ' ' 

<html> 

<body bgcolor="#FFFFFF" text=" #000000 "> 
<h2>Statistiche sui file</h2> 



<form name="form1" method="post" action="<?php echo 
$_SERVER [ ' PHP_SELF '];?>"> 

Nome del file:<input type="text" name="f ilename"> 

<input typf'submit" name="submit" value="Invia nomo file"> 

<input typo»"P»Bet" name="Reset" value="Reimpo8ta*> 



' Il IIWI I I II gtouui It UCI ine 



</form> 



</body> 
</html> 



L'output ottenuto da questo script è quello della Figura 27.3. 



3http://localhost/phpbook/esempio27-3,php - Microsoft Internet Explorer 



Preferiti Strumenti ? 





^Indietro - °* - i$ !g] g3 |. 



Indirizzo g) http://localhostiphpbookfesemplo27-3.php 



Statistiche relative al file esempk>27-l.php: 
Periferica 4 
Biode 0 

Modalità di protezione inode 33206 
Numero di collegamenti 1 
ID utente del proprietario 0 
ID di gruppo del proprietario 0 
Tipo di periferica se periferica inode 4 
Dimensione in byte 730 
ora dell'ultimo accesso 1082930400 
Ora dell'ultima modifica 1082993228 
Ora dell'ultimo cambiamento 1082993195 
Dimensione di blocco per IT/O del file system -1 
Numero di blocchi allocati -1 

Statistiche sui file 



Nome del file 




| Operazione completata" ' " [" 



Figura 27.3 

Statistiche relative alle dimensioni in byte. 



Verifica degli attributi dei file 

Le quattro funzioni di cui all'elenco che segue consentono di esaminare le proprietà 
degli attributi dei file. Tali funzioni permettono infatti di verificare facilmente se un 
file è leggibile, scrivibile, eseguibile o caricato. 
La sintassi delle funzioni e riportata di seguito. 

bool is_readable( strino nomatilo); 
bool is_writal)l.)(Mi mg nomo ti lo); 
bool is_executablo(itrin(j nompfilo) 
bool is_uplondmi i i i 



314 Capitolo 27 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalle funzioni. 





Nome 


Tipo 


Descrizione 


nomefile 


String 


il nome del file e il relativo percorso 






fli li^tfms comolcto. 


Restituzione di is_readable( ) 


^ it r\ 1 n'atn 

□ OOXcdll 


tóme se il nome di file specificato esi- 






«re ed è leggibile. 


Restituzione di is_writable( ) 


boolean 


tdiif cp il nr*mp di file snecificato esi- 






ste ed è scrivibile. 


Restituzione di is_executable( ) 


boolean 


rniir .. ~ :1 Ann./, .-li tìlo cr\t^<— ÌTl/^ltfS (^^1— 

TRUE se il nome ut me speciiu-diu 






ste ed è eseguibile. 


Restituzione di 


boolean 


TRUE se il file nominato da Alenarne è 


is uploaded_file() 




stato caricato tramite HTTP POST. 



Esempi di funzioni: 



$checkReadable = is_readable( "/home/ book/f ile .txt ); 
ScheckFileWriteable = is_writable( » /home /book/f ile. txt ), 
ScheckDirWriteable = is_writable( " /home/book/ "); 
$checkExecutable = is_executable("/usr/sbin/ping ); 
ScheckUploadedFile = i S _uploaded_f ile( "/home/book/ upload.txt ), 

Queste funzioni non agiscono sui file remoti, pertanto il file da esaminare dev'esse- 
re accessibile tramite il filesystem del server. La funzione is_writeable< ) e un 
alias di is_writable() e l'argomento nomfile potrebbe essere il nome di una 
directory che consente di verificare se essa è scrivibile. 
La funzione is_execuf able ( ) non è disponibile per le piattaforme Win32. 



Modifica di un file 

Le funzioni dell'elenco che segue possono essere utilizzate per eseguire con un file le 
operazioni principali messe a disposizione da un filesystem come copiare, n», 
cancellare, creare un collegamento simbolico e modificare le autonzzaziom di un file. 
La sintassi delle funzioni è riportata di seguito. 

int copy(string origine, string destinazione); 
bool renarne (string vecchionome, string nuovonome) ; 
int unlinkfstring nomefile); 
int delete(string nomefile); 

int symlink (string destinazione, string collegamento), 
int chmod(string nomefile, int modalità); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 



Tipo 



Descrizione 



nomefile 

origine 
destinazione 

vecchionome 
nuovonome 



string II nome del file e il relativo percorso di siste- 
ma completo, 
boolean II nome del file di Origine, 
boolean II nuovo nomo del file. Una copia grezza del 
file di origini' 

string 11 »"""• ' l,d "'' 
string 11 nuovo minte iM «le 



Nome 



Tipo 



Descrizione 



destinazione 

collegamento 
Restituzione di copy ( ) 

Restituzione di renarne ( ) 
Restituzione di unlink( ) 
Restituzione di delete ( ) 
Restituzione di symlink ( ) 

modalità 



string 

string 
int 

boolean 
int 

int 
int 



Il nome del file di destinazione del collega- 
mento. 

Il nome del collegamento. 

TRUE se l'operazione di copia ha avuto esito 
positivo. 

TRUE se l'operazione di rinomina è riuscita. 
TRUE se l'operazione è riuscita. 



TRUE se la creazione del collegamento simbo- 
lico è riuscita. 
Modalità delle autorizzazioni del file (per 
esempio 0755). 



Esempi di funzioni: 



ScopyFile = copy ("/home/book/test. txt" , " /home/book/test2.txt 
SrenameFile = rename( " /home/book/test .txt" , "/home/book/test. 
SdeleteFile = unlink( " /home/book/test .txt" ) ; 
SdeleteFile = delete ( " /home/book/test .txt" ) ; 
ScreateLink = symlink ( " /home/book/test .txt " , " /home/book/test .link" ) ; 
SchangeMode = chmod("/home/book/test.txt" , 0755); 

| La funzione unlink( ) viene utilizzata per cancellare file, collegamenti simbolici e 
directory, mentre la funzione delete ( ) è un alias di unlink( ). Queste funzioni 
non agiscono sui file remoti, pertanto il file da utilizzare dev'essere accessibile tra- 
mite il filesystem del server. 



Gestione delle directory 



Così come le funzioni precedenti consentivano di manipolare i file, PHP mette a di- 
sposizione le funzioni seguenti, che permettono di manipolare le directory. 
La 



sintassi delle funzioni è riportata di seguito. 



int mkdir(string percorso, int modalità); 
bool rmdir(string nomedir); 

bool rename(string vecchionome, string nuovonome); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 



Tipo 



Descrizione 



percorso 
modalità 

nomedir 

vecchionome 

nuovonome 

Restituzione di mkdir( ) 
Resiiiuzione di rmdir( ) 



string 
int 

string 
strino 
string 
int 

booioon 



ita la directory. 

iel file (per esempio 



Resiiiuzione ili rennmo() l>" 



Percorso reale dove sarà ere 
Modalità di autorizzazione 
755). 

Directory da eliminare. 
Nome corrente del file. 
Nuovo nome del file. 

Ri istituisce I in caso di successo, 0 in caso contrario. 
Restituisce TRUE in caso di successo, FALSE in ca- 
' mirarlo, 

Hi «liuti» e TRUE In caso di successo, FALSE In ca- 

■ llltl.llll I 



Esempi di funzioni: 

ScreateDir = mkdir( " /horae/book/new" , "0755"); 
SrmDir = rmdir( "/home/book/new" ) ; 

SrenameDir = rename( " /home/book/old" , Vhome/book/new) ; 

Quando si crea una nuova directory con mkdir ( ) , è possibile assegnare le modalità 
per le autorizzazioni con il parametro modalità. Si dovrebbe inoltre specificare il per- 
corso originale, mentre l'ubicazione in cui si creerà la nuova directory dovrebbe avere 
le autorizzazioni di scrittura. Quando si utilizza rmdir( ), la directory specificata do- 
vrebbe essere vuota e le autorizzazioni più importanti devono consentire l'operazione. 



Apertura e lettura di una directory 

Esistono tre funzioni molto potenti che danno la possibilità di aprire una directory 
nel filesystem e di leggerne il contenuto prima di chiuderla. In questo modo possili 
mo vedere (e, volendo, visualizzare) il contenuto della directory. 
La sintassi delle funzioni è riportata di seguito. 



Bouree opendir (string percorso); 
ring readdir (resource dirHandle) 



rese 
string 

void closedir( resource dirHandle) 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 







Tipo 



Descrizione 







— 



percorso 
dirHandle 



string 

: 



Restituzione di opendir ( ) 
Restituzione di readdir ( ) 



ssource 

resource 
string 



- ito da open- 



Restituzione di closedir( ) void 



La directory da utilizzare con il percorso di si- 

EndleT Plet ° 
dir(). 

Handle della directory. 

Nome(i) del file successivo tratto dalla di- 
rectory. 

Non restituisce alcunché. 



Esempi di funzioni: 

SopenDirectory = opendir ( "/home/ book/new" ) ; 
SreadDirectory = readdir ( SopenDir ) ; 
ScloseDirectory = closedir(SopenDir) ; 



Se "percorso" non è una directory valida, o se la directory non può essere aperta per li 
nutazioni nelle autorizzazioni o per errori nel filesystem, opendir ( ) restituisce FALSE 
e genera un errore PHP. Per prevenire errori simili, inserite un simbolo @ davanti a cia- 
scuna funzione in modo da impedire che Tenore venga visualizzato nel browser (per 
esempio, $open = ©opendir ( ..);)• Questa soluzione è stata citata per la prima volta 
nel Capitolo 24. Lo script seguente mostra un esempio di utilizzo di queste funzioni. 



<?php 



// Gestione d«i file • Esempio 27-4 



Idatafile = "f iles/data.txt" ; 

if (isset($_POST[ 'submit' ])){ 
Sdirname = $_POST[ 'dirname' ] ; 
if (is_dir($dirname) ) { 

echo "<h2>Contenuto della directory Sdirname:</h2>" ; 
$dir = opendir ($dirname) ; 
while($file = readdir ($dir ) ) { 
echo "Sfile<br />"; 

I 1 

closedir($dir) ; 

I) 
else 

echo "Sdirname non è una direcyory."; 

?> 

<html> 

<body bgcolor="#FFFFFF" text=" #000000 "> 
<h2>Contenuto della directory</h2> 

<form name="form1" method="post" action="<?php echo 
$_SERVER[ 'PHP_SELF' ] ; ?> "> 

Nome della directory :<input type="text" name=" dirname "> 
<input type=" submit" name="submit" value="Invia nome file"> 
<in P ut ty P e="reset" name="Reset» value="Reimposta»> 

</form> 

</body> 
</html> 

Lo script è una nuova versione degli esempi proposti in precedenza in questo capi- 
li ilo. La parte più interessante è la sezione in cui il nome della director)' viene veri- 
peato per stabilire se si tratta effettivamente di una directory, quindi il contenuto 
della directory viene letto e visualizzato con un ciclo while. 

Sdirname = $_P0ST[ 'dirname' ] ; 
if (is_dir($dirname) ) { 

echo "<h2>Contenuto della directory $dirname:</h2>" ; 

Sdir = opendir (Sdirname); 

while($file = readdir(Sdir) ) { 
echo "$file<br />"; 

} 

closedir(Sdir) ; 
L'output ottenuto da questo script è quello della Figura 27.4. 




Contenuto della directory files: 



test.txt 
test2.txt 
data.txt 



■ 



Contenuto della directory 



Nome della directory:! 




Figura 27.4 

Visualizzazione del contenuto della directory. 

Riepilogo 

In questo capitolo sono state introdotte altre funzioni utilizzabili per modificare e 
creare file e directory. Avete visto come utilizzare le funzioni per ottenere Statistiche 
relative a un file, cancellare e spostare file e directory e persino visualizzare l'intero 
contenuto di una directory. Nel prossimo capitolo sarà introdotto il concetto di cari- 
camento di file. 



" 



Capitolo 28 

Caricamento 

di file tramite i moduli 



Introduzione 



I moduli consentono agli utenti di inserire dati tramite campi, come i campi per il 
testo o per le password; i moduli sono stati introdotti nel Capitolo 18. In quella trat- 
tazione è stato omesso un tipo di campo che consente a un utente di inviare un in- 
tero file assieme al modulo. Il tipo di input "file" per il moduli consente agli utenti 
di sfogliare le directory del computer locale e selezionare un file da caricare sul ser- 
ver Web. 

Una volta caricato, è possibile scrivere uno script PHP per accedere a questo file, 
spostarlo, archiviarlo e, come si vedrà, utilizzi"- 1 

Tipo di input file per i moduli 

Per dar vita a un modulo che consenta di caricare un file, è necessario inserire l'at- 
tributo enctype nell'elemento forni con il valore multipart/f orm -data, in modo 
da informare il server che il modulo potrebbe contenere un file caricato: 

<form enctype=' multipart/f orm-data 1 action=' forni. php 1 method='post'> 

All'elemento input è possibile assegnare l'attributo type="file" per creare un 
Rampo di input del modulo che consenta di sfogliare le directory della macchina Io- 
cale e selezionare un file da caricare sul server. Il formato di questo elemento è il 
Kguente: 

<input name='myFileName' type='file'> 

inoltre possibile limitare la dimensione massima in byte attraverso un campo na- 
scosto in cui la variabile di .sistema MAX_FILE_SIZE è impostata su un certo valore. 
[DI seguito se ne riporta mi esemplo: 

<input type='hidden' naoiO"'MAX_PILE_8IZE' value=' 1 00000 1 > 



Quello che segue e invece un esempio di modulo contenente un « stinpo per il cari- 
camento di file. 



<?php 




// Caricamento di file - Esempio 28-1 



?> 

<form enctype='multipart/form-data' action= 1 <?php echio 

$_SERVER["PHP_SELF"]; 

?>' method='post'> 

<input type='hidden l name= ' MAX_FILE_SIZE 1 value= ' 1O000O'> 
File di documento: <input name= 1 myf ile' type='file' 
value= ' Sfile 1 ><br><br> 

<input type= 1 submit' value=' Invia il documento' name='send'> 
</form> 

La Figura 28.1 illustra come appare questo modulo quando viene visualizzato in un 
browser. 
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Figura 28.1 

Un semplice modulo perii caricamento di file. 



Potete inserire il nome e il percorso del file da caricare nel campo del modulo op- 
pure fare clic sul pulsante Sfoglia per aprire una finestra di selezione dei file che 
consenta di individuare il file da caricare. Questa finestra è quella della Figura 28.2. 
Sfortunatamente, anche se il modulo è stato creato, non esiste ancora un codice 
PHP in grado di accedere a esso. 



Accesso a un file caricato con PHP 



I passi da • <>m|.i, i. ,..<■ •.. livere uno script PHP in grado 'li accedere a un l'ile cari 
cato sono divariti I necessario muoversi con prudenza In modo da agire corretta 
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mente, in quanto si tratta di un'operazione che comporta alcuni rischi per la sicu- 
rezza. Prima di affrontare la procedura da seguire, osservate come funziona il cari- 
camento di file in PHP. Il processo è illustrato nella Figura 28.3. 
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Figura 28.3 

[Funzionamento del caricomonio ■ i 




Quando un file viene caricato attraverso un modulo, viene archiviato in una di- 
rectory temporanea, come mostrato nella Figura 28.3. Questa directory è specificata 
dallo sviluppatole e dipende dal sistema operativo presente sul computer. Il file 
viene archiviato con un nome temporaneo generato da PHP. Vengono create un 
paio di variabili ambientali che consentono di memorizzare il nome temporaneo e 
quello reale del file. PHP contiene alcune funzioni che permettono di determinare 
se il file temporaneo è stato effettivamente caricato tramite un modulo PHP e, in tal 
caso, renderanno possibile il trasferimento del file alla sua destinazione finale con il 
nome originale. Queste funzioni offrono una certa protezione dai possibili intrusi. 
Esaminate le diverse istruzioni PHP che consentono di accedere ai file caricati. In- 
nanzitutto, la directory temporanea in cui vengono collocati inizialmente i file cari- 
cati viene impostata con la variabile ambientale $TMPDIR. Per esempio: 



$TMPDIR = "c: UTempUuploads" ; 



Questo esempio imposta la directoiy temporanea a c:\temp\uploads. Osservate 
l'utilizzo della sequenza di escape (\ \) che consente di specificare un carattere "\". 
Una volta caricato il file, il nome assegnato al campo del modulo (nell'esempio pre- 
cedente era myf ile) viene utilizzato per memorizzare il nome temporaneo e quello 
reale del file in un array variabile ambientale chiamato $HTTP_POST_FILES. L'ac- 
cesso al nome temporaneo e a quello reale del file può avvenire nel modo 
seguente: 

$f ilename = $HTTP_POST_FILES[ 'myf ile 1 ] [ "tmp_name 1 ] ; 
Srealname =$HTTP_POST_FILES[ 'myf ile 1 ] [ 'narae' ] ; 

È importante accedere a queste informazioni, in quanto dovete utilizzarle per accer- 
tare che si tratti di un file autentico caricato correttamente. A tal fine utilizzate la 



funzione is_uploaded_f ile( ) . 

La sintassi della funzione è la seguente. 

bool is_uploaded_f ile(string nomefile); 

■ 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 



Tipo 



Descrizione 



nomefile 

Restituzione di 
is_uploaded_f ile ( ) 



string II nome del file di cui occorre verificare il carica- 

mento. 

string Un valore TRUE se il file è un file caricato valido, 

altrimenti restituisce FALSE. 



Esempio di funzione: 
$res = Is-Iploaded_file($filename) ; 



Se il file è autentico, può essere spostato e rinominato con la funzione 
move_uploaded_f ile ( ) . 
La sintassi della l'unzione è la seguente. 



bool movo. uplondod_file(string nomefile, string destinazione); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


■ nninp'f i 7 p 

llUlilo 1 XXC 

destinazione 
Restituzione di 
move_uploaded_f ile() 


st ririQ 
string 
boolean 


: , 

Il nome temporaneo del file caricato. 
Il nome e la posizione in cui spostare il file. 
Un valore TRUE se lo spostamento del file è riu- 
scito, altrimenti restituisce FALSE. 



Esempio di funzione: 



move_uploaded_f ile(Sf ilename, ("c: \\Programmi\\httpd\\HtDocs\\bigbook\\uplo 
adsU" .$newname) ) ; 

WL ■ - 

Ora disponete di informazioni sufficienti per creare un semplice programma per il 
caricamento di file. 



Semplice caricamento di file 



fioni.jpg ed erba.jpg e sono quelle della Tabella 28.1. 



Tabella 28.1 I file delle immagini con i loro nomi 



f 




I 





I 



soffioni.jpg 







puntiblu.jpg 





indi, è stato creato un semplice modulo per il caricamento di file che consente di 
caricare due file, ai quali sono stati assegnati i nomi immaginel e immagine2; lo 
script è il seguente: 



ipt 
<?php 

// Caricamento di file • EMmpio 28-2 

»/• 

?> 



<form onctypo 'muli <i-'«l0mpio28-3.php 'method"'po8t'> 



<input type='hiddon' nam9-'MAX_FILE_SI2E l valilo* ' 10M8W» 
Prima immagine: <input name= 1 immagine 1 1 type='f ilo><br> 
Seconda immagine: <input name=' immagine2' type= 1 f ile ' ><br><br> 
<input type='submif value=' Invia le immagini' name='send'> 

</form> 

Questo modulo è quello della Figura 28.4. Il modulo è stato progettato in modo da 
caricare due delle quattro immagini create in precedenza, benché non vi sia alcun 
controllo di errore che garantisca che i file caricati siano effettivamente immagini. 




$TMPDIR = "c:\\Temp\\uploads"; 
$f ilename = $HTTP_POST_FILES[ ' immaginel ' ] [ 1 tmp_name 1 ] ; 
if ( is_uploaded_f ile ($f ilename ) ) 

move_uploaded_f ile ($f ilename , "c : \\ InetpubV \wwwroot \ \ phpbook\ \ 
graphicsWimmagine1.jpg"); 



Sfilename = $HTTP_POST_FILES[ 1 immegine2' ] [ ' tmp_name' ] ; 
if (is_uploaded_f ile (Sfilename)) 

move_uploaded_f ile (Sfilename, "c: \\Inetpub\ \wwwroot\\phpbook\\ 
graphicsWimmagine2.jpg"); 

?> 

<img src="graphics\immagine1 . jpg"> 
<br> 

<img src="(|rnphios\immagine2. jpg"> 



— 

<br> 

<a href="esempio28-2.php">Torna</a> al modulo di caricamento. 

Lo script verifica che il primo file (immaginel) sia un file valido e lo sposta in: 

"c: \\Inetpub\\wwwroot\\phpbook\\graphics\\immagine1 . jpg" 

Poi è il secondo file (immagine2) a essere verificato e spostato in: 

"c: \\Inetpub\\wwwroot\\phpbook\\graphics\\irnmagine2. jpg" 

Infine, lo script visualizza le due immagini con l'elemento <IMG SRC> e fornisce un 
collegamento ipertestuale per tornare al modulo di caricamento. Un esempio di 
output di questo script è quello della Figura 28.5. Ovviamente le immagini visualiz- 
zate dipenderanno dalle immagini che scegliete di caricare. 
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Toma al modulo di caricamento. 



Figura 28.5 

Visualizzazione delle immagini caricate. 



" 



Protezione del caricamento di file 



■ 



Benché l'esempio precedente descriva il funzionamento del meccanismo di carica- 
mento e manipolazioni- « l« - 1 li!<\ i-,-,o nu-iii- anche in luce un importante problema: 
la sicurezza. Ncll'i-si-mpio pn-n-ili-nii- non viene effettuato alcun controllo su chi 
carica le immagini, pertanto i hlUIK)Ufl 1 onOBCfl l'Indirizzo della pagine del modulo 
di caricamento può . .ni limili i|ttrllv Installale in precedenza. Perora que- 



sto non comporli! j^ravi conseguenze, ma se il inculi il- > |c >v.r ( uni cplio per caricare 
file relativi a documenti che solo determinati utenti hanni 1 1 >Ut< Il IZZBZlone a inviare, 
sarebbe necessario un ambiente più sicuro. 

Per ovviare al problema, occorre innanzitutto creare un meccanismo che consenta 
l'identificazione di chi sta cercando di caricare un documento e di stabilire se si de- 
sidera consentire l'operazione. Un semplice sistema con nome utente e password 
potrebbe essere sufficiente. A tal fine, per prima cosa si utilizza Blocco note per 
creare un semplice file dove ogni coppia di nome utente e password è elencata su 
righe separate del file. Ogni nome utente è separato dalla propria password da uno 
spazio. La Figura 28.6 illustra un esempio di file di questo genere, che può essere 
salvato con il nome password.txt. Non salvatelo nella directory del server Web, al- 
trimenti i potenziali hacker potranno accedervi e visualizzare l'elenco dei nomi 
utente con le relative password. 




Figura 28.6 

File con nomi utente e password. 

Ora siete pronti per creare l'applicazione per l'invio di file. 
<?php 

// Caricamento di file - Esempio 28-4 



if (isset($_POST[ 'username'])) 

Susername = $_POST[ 1 username '] ; 
else 

Susername = " " ; 
if (isset($_POST[ 'password'])) 

Spassword = $_POST[ ' password ' ] ; 
else 

Spassword = ""; 
if (isset($_POST[ 'file'])) 

Sfile = $_POST[ 'file' ); 



else 

Sfile = ""; 

SpasswordOkay = 0; 

if (isset($_POST[ 'sentì'])) { 



Sokay = checkUsernamePassword( "c : \ \Temp\\password. txt " , 



Susername, Spassword); 
if (Sokay) { 

SpasswordOkay = 1 ; 
STMPDIR = "c:\\Tenip\\uploads"; 

$f ilename = $HTTP_POST_FILES[ ' myf ile ' ] [ 'tmpjiame' ] ; 
Srealname = $HTTP_POST_FILES[ ' myf ile 1 ] [ "name ' ] ; 
if (is_uploaded_f ile ($f ilename) ) { 
Sdate = fDate(); 
Stime = fTime( ) ; 
Snewname = (Srealname . "-" . Sdate . "-" . Stime); 
move_uploaded_file($filename, ( "c: \\Inetpub\\wwwroot\\ 

phpbook WuploadsW ". Snewname) ) ; 
appendToFileCuploadsUuploads.txt", 

Sdate . " ". Stime . " " .Susername . " " . Srealname); 
echo( "Grazie per aver inviato il documento. 

Fare clic su <a href='esempio28-5.php'>qui</a> 
per vedere un elenco dei documenti inviati."); 

} 

l } 

else 

echo("Nome utente e/o password non corretti."); 

i 

Sphpself = $_SERVER[ 'PHP_SELF' ] ; 
if(!isset($_POST[ 'sentì']) Jj SpasswordOkay == 0) { 

echo("<h2>Benvenuti alla pagina per l'invio dei documenti</h2>" ) ; 
echo("Si prega di compilare il modulo e di premere il pulsante per 

l'invio del file.<P>"); 
echo("<form enctype= 'multipart/ forni -data' action= 'Sphpself 

method='post'>" ) ; 
echo("<input type='hidden' name='MAX_FILE_SIZE' value= ' 100000 '>") ; 
echo("Nome utente: <input type='text' name=' username ' 

value=' Susername '><br>") ; 
echo( "Password: <input type=' password ' name=' password 

value=' Spassword '><br>" ) ; 
echo("File di documento: <input name= 'myf ile' type='file' 
value=' Sfile '><br><br>" ) ; 



ri 1 



} 



echoi 



echo( "</form>" ) ; 



"<input type='submit' value=' Invia il documento' name=' send">" ) ; 
"</form>"): 



function fDate() { 
Sdate = getdate() ; 
SmonthText = Sdate [ "month" ] ; 
Syear = $date[ "year" ] ; 
Smday = Sdate [ "mday" ] ; 

return Smday . "-" . SmonthText . "-" . Syear; 

} 



function fTlme() { 
Stime = localtlmol) 
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return Stime [2] . . $time[1] . "-" . Stimolo; 
} 

function appendToFile($file,$data) { 
$out = fopen($file,"a"); 
fputs($out, Sdata. "\n"); 
fclose(Sout); 

function checkUsernamePassword(Sfile,$username, Spassword) { 
$found=0; 

$in = fopen($file,"r"); 
Siine = fgets (Sin, 4096); 
while(!feof (Sin) && !$found) { 

SsplitLine = explode (" ", Sline); 

$splitLine[1 ] = substr ($splitLine[1 ] ,0,strlen($splitLine[1 ] ) -2) ; 
if ($splitLine[0] == Susername && SsplitLine[ 1 ] == Spassword) 

$f ound=1 ; 
Sline = fgets( Sin, 4096); 

fclose(Sin) ; 
return Sfound; 

?> 

È un po' più lungo rispetto al primo esempio, ma non preoccupatevi: sarà esamina- 
to in dettaglio per spiegare cosa accade nelle varie fasi. La prima parte dello script 
ottiene le variabili del modulo: 



if (isset($_POST[ 'username' ] ) ) 

Susername = S_POST[ 1 username' ] ; 
else 

Susername = " " ; 
if (isset($_POST[ 1 password 1 ])) 

Spassword = $_POST[ 'password' ] ; 
else 

Spassword = " " ; 
if <isset($_POST['file'])) 

Sfile = S_POST[ 'file']; 
else 

Sfile 

n 



SpasswordOkay = 0; 



La parte successiva dello script verifica che i dati del modulo siano stati inviati e, in 
tal caso, richiama la funzione checkUsernamePassword ( ), passandole come para- 
metri la posizione del file delle password, il nome utente e la password: 

if (isset($_P0ST['8end'])) { 

Sokay = chockUsernamePassword("c: \\TempWpasswcrd.txt" , 
Susornnme , Spassword) ; 

La funzioni- chockU8ernamePassword( ) restituisce <> se il nonn- mente o la pass- 
word „,.,, . umo oppure I se va tutto bene. Si tornerà In se K ullo su questa funzio- 
na (|11iI ikIo n< wirfl lornlia la definizione, più avarili nel Usuilo Se la password e il 



nome utente sono validi, la parte successiva dello script imposta la directory tempo- 
ranea e accede ai nomi temporanei e reali del file caricato; quindi verifica che si 
tratti di un file caricato valido chiamando la funzione is_uploaded_f ile( ). 

if (Sokay) { 

SpasswordOkay = 1 ; 

STMPDIR = "c:\\Temp\\uploads"; 

Sfilename = $HTTP_POST_FILES[ 'myfile' ] [ 'tignarne" ] ; 
Srealname = $HTTP_POST_FILES[ 'myfile' ][ 1 name' ] ; 
if ( is_uploaded_f ile ( Sfilename ) ) { 

Se il file deriva da un caricamento valido, la data e l'ora vengono ottenute chiaman- 
do le funzioni f Date ( ) e f Time ( ) . La data e l'ora restituite da queste funzioni ven- 
gono utilizzate per creare un nuovo nome di file che incorpora il nome di file reale 
—ieme alla data e ora: 



i 

Sdate = fDate(); 
Stime = fTime() ; 

Snewname = (Srealname . "-" . Sdate . . Stime); 

file viene quindi spostato in una directory precedentemente creata, chiamata 
uploads. Se volete, potete cambiare la posizione di questa directory: 

m 

move_uploaded_f ile (Sfilename , ( " c : \ \ Inetpub\ \wwwroot \ \ 
phpbookUuploadsU" .Snewname) ) ; 

Viene chiamata la funzione appendToFile( ), cui vengono passati come parametro 
il nome del file da scrivere, la data, l'ora, il nome utente e il nome reale del file 
come singola stringa. Infine, viene visualizzato un messaggio che conferma l'invio 
del documento e chiede all'utente se desidera visualizzare un elenco dei documenti 
Inviati: 

appendToFile( "uploadsWuploads.txt" , 

Sdate . " ". Stime . " " .Susername . " " . Srealname); 
echo( "Grazie per aver inviato il documento. 

Fare clic su <a href='esempio28-5.php'>qui</a> 




■ », ^ "k.-> r-r -i — 

per vedere un elenco dei documenti inviati."); 

K x 

Se il nome utente e la password non sono corretti, viene visualizzato un messaggio 
che informa l'utente dell'errore: 

else 

echo( "Nome utente e/o password non corretti."); 

Se il modulo non è stato inviato, o il nome utente/password non sono corretti, vie- 
ne visualizzato il modulo, costituito da campi che consentono all'utente di inserire il 
nome utente e la password e di selezionare il documento da inviare: 

Sphpself = $_SERVER['PHP_8ELF']; 

if (!isset($_POST[ 'aend' )) !! IpoeewordOkay == 0) { 

echo("<h2>BenvonuU alla pagina per l'invio dei documenti</h2>" ) ; 

echo("Si prega di compilino il modulo • di premere il pulsante per 
l'invio dol file.*!' 



echo("<forni enctypB-'multipart/form-data' action- 'IphpMlf ' 

method-'po8t'> M ) ; , 
echo("<input type='hldden' name= 1 MAX_FILE_SIZE ' value= ' 100000 > >, 
echo("Nome utente: <input type='text' name='username' 

value='$username'><br>"); / 
echo(" Password: <input type=' password 1 name=' password' 

value=' Spassword '><br>") ; , 
echoCFile di documento: <input name= 'myf ile 1 type= file 

value='$file'><br><br>">; I'Ì^h^-v. 
echo(»<input type='submif value='Invia il documento' name= send > ), 
echio ("</form>") ; 

},...'. . : ■ . :i.-\r^ ■ " •■"/. : ! 

L'ulteriore parte del programma è costituita dalle funzioni definite dall'utente chia- 
mate in precedenza; le prime due sono fDateQ e fTime<), che restituiscono la 
data e l'ora come stringhe: 

function fDate() { 
$date = getdate(); 
SmonthText = $date["month"l; 
Syear = $date[ "year" ] ; 
$mday = $date[ "mday"] ; 

return Smday . "-" . SmonthText . "-" . $year; 

} 

function f T±me(J { 

Stime = localtime(); , 
return $time[2] . "-" • $time[1] •. "-" • $time[0]; 

} 

La funzione appendToFile( ) scrive un record relativo al documento appena cari- 
cato nel file uploads.txt. Questo file di testo viene utilizzato dal secondo program- 
ma PHP per visualizzare i documenti che sono stati cancan: 

function appendToFile( Sfile, $data) { 
$out = fopen($file,"a"); 
fputs($out,$data."\n»); 
foiose (Sout) ; 

La parte finale del programma è costituita dalla funzione^ checkUsername- 
Password ( ) , che apre il file passwords.txt e ne legge tutte le righe: 

function checkUsernamePassword($file,$username, Spassword) { 
$found=0; 

Sin = fopen($file,"r"); 
Sline = fgets (Sin ,4096); 
while(!feof (Sin) && ISfound) { 

Ogni riga del Rie viene separata con la funzione explode() per ottenere il nome 
utente e la password memorizzata : 

SsplitLin» • »xplode (" \ Sline); 



Dato che i l'ile eli testo spesso inseriscono caratteri di avanzamento riga alla fine di 
ogni riga, questi vengono rimossi con la funzione substr( ), che elimina gli ultimi 
due caratteri nascosti dalla stringa: 

SsplitLine[1 ] = substr($splitLine[1 ] ,0,strlen($splitLine[1 ] ) -2) ; 

Il nome utente e la password passati alla funzione vengono confrontati con quelli 
letti dal file e, se corrispondono, la variabile $f ound viene impostata a 1; questo va- 
lore viene quindi restituito alla funzione: 

if ($splitLine[0] == Susername && SsplitLine[1 ] == Spassword) 

$f ound=1 ; 
Sline = f gets (Sin, 4096) ; 

HI; 

f close(Sin) ; 
return Sfound; 



output prodotto da questo programma è quello della Figura 28.7. 
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— 



Figura 28.7 

La schermata per il caricamento di file sicuri 



i 



Se vengono inseriti un nome utente e una password corretti e quindi viene caricato 
un file, appare il messaggio del la Figura 28.8. 

Lo stadio successivo consisti' nella creazione del programma che visualizza i docu- 
menti caricati quando l'utente MlMlOIU il collegamento ipertestuale qui. Il prò- 
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Grazie per aver inviato il documento. Fare clic su gwper vedere un elenco dei documenti 
inviati. 



j Operazione completata 



Figura 28.8 

Caricamento riuscito. 

gramma si limita ad aprire il file uploads.txt e a leggerne tutte le righe: I dettagli re- 
lativi a ciascun file caricato vengono visualizzati in una tabella: 

<h2>Documenti inviati</h2> 
<table border=1> ' 



<tr bgcolor='cyan'> 

<td width=130>Data</td> 

<td width=80>Ora</td> 

<td width=100>Nome utente</td> 

<td>Documento< / td> 
</tr> 

<?php 



// Caricamento di file - Esempio 28-5 

// -■■ 



$in = fopen("uploads//uploads.txt","r"); 
Siine = fgets($in,4096); 
while(!feof (Sin)) { 

SsplitLine = explode (" ", Siine); 
echo("<tr bgcolor='lightgreen'> 

<td>" . SsplitLine [0] . "</td> 
<td>" . $splitLine[1] . "</td> 
<td>" . $splitLine[2] . "</td> 
<td> 

<a href='uploads\\" . $splitLine[3] . 

»-» . $splitLine[1] . '">" . SsplitLine[3] . "</a> 
</td> 
</tr>"); 
Sline = fgets($in,4096) ; 

} 

fcloso($in) ; 



. $splitLihe[0] 



?> 



II I l ILI I MI UIC II, Il IIIH- I MIUUUII 



</table> 

<a href='esempio28-4.php'>Torna</a> alla pagina di invio dei documenti. 

Un esempio di output di questo programma è riportato nella Figura 28.9- 
L'utente può accedere ai file caricati facendo clic sul nome del documento. In rela- 
zione al tipo di documento, esso sarà visualizzato (come nel caso di un file di im- 
magine) oppure, nel caso si tratti di un documento, il sistema potrebbe chiedere 
all'utente se desidera scaricare una copia del file sul proprio computer. 
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Documento 
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Simon 





Toma alla pagina di invio dei documenti. 



Figura 28.9 

Documenti caricati. 



iepilogo 

Questo capitolo ha introdotto il concetto di caricamento dei file tramite un modulo. 
Si è visto come sia possibile ottenere questo risultato e il possibile utilizzo di questo 
strumento. Si è evidenziata la necessità di valutare problemi di sicurezza nel carica- 
mento e si è analizzato come PHP possa accertare che i file caricati siano autentici, 
oltre a ciò che il programmatore deve fare per limitare l'accesso degli utenti. Nel 
prossimo capitolo si vedrà ciò che PHP può ottenere con la manipolazione di sem- 
plici immagini. 



Capitolo 29 

Semplici manipolazioni 
di immagini 



lì 

■ itili 

Introduzione 



meste/capitolo illustra come utilizzare PHP per eseguire semplici manipolazioni di im- 
lifii. La capacità di eseguire questo genere di modifiche consentirà di sviluppare siti 
meh più dinamici, dall'aspetto molto ricercato e con una migliore accessibilità. Le ma- 
nipolazioni di immagini che analizzeremo sono operazioni semplici, come scegliere 
fenili' immagine visualizzare oppure ridimensionare e ingrandire un'immagine. Malgra- 

. i l 1: -.'.-A , Ai /.n^^ ■ ltvi*i -Il h itrr-, ricnorfA 



In loro semplicità, queste operazioni permettono di ottenere risultati di tutto rispetto. 



Sostituzione di un'immagine 

Ino tra le funzioni più semplici che PHP è in grado di gestire è il controllo delle int- 
uii che compaiono sui siti Web. Molto spesso i progettisti Web desiderano che i 
Bri ipri siti appaiano come se fossero in costante evoluzione, senza richiedere un'ec- 
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Figura 29.1 

Bina normalissima immagine Web, 



cessivi! manutenzione. Molti progettisti, per esemplo, .le, («tono ili Inserire nei prò 
pn siti una serie di immagini che cambiano in base al perìodo ddfànno, 
Prendete in considerazione per un attimo la Figura »). I . hr illustra un tipico logo 
Web di un'azienda. 

L'obiettivo è fare in modo che il logo cambi in base alla data in cui viene visualizza- 
ta la pagina Web. Quindi, se l'utente visualizza la pagina la vigilia di Natale, vedrà il 
logo rappresentato nella Figura 29.2, mentre il giorno di Natale comparirà il logo il 
lustrato nella Fieura 29.3. 
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Figura 29.2 

Logo per la vigilia di Natale. 
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Logo per il giorno eli NaUlt. 
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Per fortuna, il codice necessario per apportare queste modifiche è molto semplice. 
<?php 

I.' 0 i 

Il Semplici immagini - Esempio 29-1 

M- ■ --- . 

Sdate = getdate(); . 
Sday = $date[ "mday"] ; 
Smonth = Sdate [W]; 
if($day == 25 && $month== 12) 

echo ( "<img src= 1 graphics/simoncomna . j pg ' > " ) ; 
elseif($day == 24 && $month== 12) 

echo( "<img src= 'graphics/simoncomvn. jpg ' >" ) ; 
else \ 

echo( "<img src=' graphics/simoncom. jpg '>" ) ; 

l \ ■ ' O - ' 

E';.;: 

Affinché questo programma funzioni occorrono tre immagini separate tra cui sce- 
gliere. Le immagini a nostra disposizione sono: simoncomna.jpg, simoncomvn.jpg e 



7 

Tabella 29. 1 Immagini dello script 




Welcome to 

simon.com 



Simoncom.jpg 




Welcome to 

simon.com 




Simoncomce.jpg 




Welcome to 

simon.com 




Ufs Christmas Day 



Simoncomcd.jpg 



II programma inizia ottenendo la data di sistema, quindi memorizza il giorno e il 
mese in due variabili: $day e $month. Per questo esempio l'anno non è necessario: 

$date = getdate( ) ; 
Sday = Sdate [ "mday" ] ; 
Smonth = Sdate [ "mon" | ; 

Quindi, utilizza un costrutto lf , elseif - else per controllare le date in modo da 
decidere quale immagini * l-.u.ill//iire 



if($day « 25 && $mo»th- 
echo("<img »rc- grtphHi»/ 



lP0>')i 
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elseif($day == 24 && $month== 12) 

echo ( " <img src= 1 graphics/simoncomvn . j pg ' >" ) j 
else 

echo ( "<img src= 1 graphics/simoncom. j pg 1 >" ) ; 

Quindi, il giorno di Natale comparirà l'immagine simoncomna . j pg, la vigilia di Na- 
tale comparirà l'immagine 'simoncornvn.jpg', mentre tutti gli altri giorni dell'anno 
l'utente vedrà il logo simoncom.jpg. Se volete provare le modifiche apportate senza 
aspettare Natale o la vigilia, inserite le due righe di codice seguenti prima dell'istru- 
zione if per impostare il mese e il giorno: 

Smonth =12; 
$day = 24; 

Ridimensionamento delle immagini 

Le immagine utilizzate nelle pagine Web hanno una dimensione fissa, in termini di 
pixel. In genere queste immagini sono visualizzate nella dimensione predefinita 
con l'elemento <img src="nomeimmagine ">. Questo elemento ha due attributi, al- 
tezza e larghezza, che consentono di specificare la dimensione esatta con cui visua- 
lizzare l'immagine, a prescindere dalla dimensione fisica dell'immagine stessa. 
Esiste la possibilità di alterare in modo dinamico i valori di altezza e larghezza di 
un'immagine, facendola apparire con nuove dimensioni. La qualità dell'immagine 
visualizzata dipende dalla dimensione originale dell'immagine stessa. Per esempio, 
un'immagine di 10 x 10 pixel ingrandita a 100 x 100 pixel avrà un aspetto "quadret- 
tato", poiché ogni pixel originale è stato moltiplicato per dieci. 




Figura 29.4 

Esempio di ridimensionamento di un'immagine. 



semplici manipolazioni ai immagini j«i 



La Figura 29.4 mostra l'esempio di un'immagine ridimensionata. La pagina Web è 
costituita dall'immagine di una palma e da un semplice modulo con due pulsanti, 
uno contrassegnato con un segno "+", l'altro con un segno "— ". Lln clic sul pulsante 
"+" ingrandisce l'immagine, mentre un clic sul pulsante "-" la rimpicciolisce. 
La Figura 29.5 mostra la medesima immagine dopo che è stata leggermente rimpic- 
ciolita con un clic sul pulsante Nel programma sono stati incorporati alcuni con- 
trolli per limitare la dimensione minima e massima di ingrandimento o riduzione 
dell'immagine. 
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Figura 29.5 

Un'immagine rimpicciolita. 



Il codice necessario per implementare questa pagina Web è il seguente: 
<?php 




// Semplici immagini - Esempio 29-2 

if(!isset($_P0ST['x'])) 

$x=150; 
else 

$x=$_P0ST[ 'x' ] ; 
if(!isset($_POST['y'])) 

$y=200; 
else 

$y=$_P0ST['y']; 
if (isset ($_P0ST[ ' bigger ' | ) ) { 
if ($_P0ST[ 'bigger' | ) { 
if($x < 300) { 
$x=$x*2; 
$y=$y*2; 

> . 



j<tz capitolo lì 



} 

if (isset($_POST[ 'smaller'])) { 
if ($_POST['smaller']) { 
if($x > 38) { 
$x=$x/2; 
$y=Sy/2; 

y 

ì 

<h2>Zoom dell'immagine</h2> 

<form action="<?php echo $_SERVER[ "PHP_SELF" ] ; ?>" method='post'> 

<input type='hidden' name='x' value='<?php echo(Sx); ?>'> 

<input type='hidden' name='y' value='<?php echo(Sy); ?>'> 

<input type='submit' name='bigger' value='+'> 

<input type= ' submit" name=' smaller ' value='-'> 



</f orra> 



<img src= ' graphics/palma. jpg' width='<?php echo($x); ?>' 
height='<?php echo($y); ?>'> 




Il programma inizia stabilen< 

if (!isset($_POST[ 'x']) 

$x=150; 
else 

$x=$_POST[ 'x' ] ; 
if (lisset($_POST[ 'y'])) 

$y=200; 
else 

$y=$_POST[ , y']; 

Successivamente, se l'utente preme il pulsante "+" i valori di $x e $y vengono rad- 
doppiati, purché il valore di $x sia minore di 300: 



if (isset($_POST[ 'bigger' ])) { 
if($_P0ST['bigger']) { 
if($x < 300) { 
$x=$x*2; 
$y=$y*2; 

. ":Vr-., ■> ' 

} 



Se invece l'utente preme il pulsante "-" i valori di $x and $y vengono dimezzati, 
purché il valore di $x sia maggiore di 38: 

if (isset($_P0ST[ 'smaller'])) { 
if($_P0ST[ 'smaller']) { 
if($x > 38) { 
$x=$x/2; 
$y $y/:'; 

} 

} 



La sezione successiva del codice visualizza il modulo Web che include i valori na- 
scosti delle variabili $x e $y : 

<h2>Zoom dell' immagine</h2> 

<form action="<?php echo $_SERVER[ "PHP_SELF" ] ; ?>" method='post'> 

<input type='hidden' name='x' value='<?php echo($x); ■?>■> 

<input type='hidden' name='y' value='<?php echo($y); ?>"> 

<input type=' submit" name=' bigger • value='+'> 

<input type=' submit' name=' smaller' value='-'> 

</form> 

Infine, l'immagine viene visualizzata utilizzando i valori di $x e $y per impostarne 
laMimensione: 

Si ?>' 



ilg src='graphics/palma.ipg' width='<?php echo($x); ?>' 
hpight='<?php echo($y); ?>'> 

Allungamento di un'immagine 

Invece di ridimensionare un'immagine senza alterare il rapporto tra altezza e lar- 
ghezza, è possibile intervenire su questi valori al fine di allungarla. Si tratta di 
un'operazione che porta alla distorsione di un'immagine normale, quindi potrebbe 
sembrare poco utile. 

Se la pensate così, avete torto. Considerate l'esempio della Figura 29.6, che illustra 
un semplice modulo e una scala percentuale. 
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Inserire un numero compreso tra 0 e 100: 



Figura 29.6 

Un semplice indicatore a barn. 




Se l'utente inserisce nel modulo un valore compreso ti.i () i liK) e poi la elic sul pul- 
sante eli invio, il valore compare sulla barra di scala, come mostrato nella Figura 297. 
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Figura 29.7 

Barra impostata al 67%. 



La capacità di creare barre di scala come questa è molto utile, poiché esse mettono 
a disposizione uno strumento grafico per rappresentare i dati nella pagina Web sen- 
za dover creare dal nulla un'immagine nuova, Ma come si crea una scala di questo 
genere? Considerate il seguente codice sorgente: 

<h2>Semplice indicatore a barre</h2> 

<form action='<?php echo($_SERVER[ 'PHP_SELF' ] ) ; ?>' method='post'> 

Inserire un numero compreso tra 0 e 100: <input type='text' name=' scale '> 
<input type='submit'> 

</form> 

<?php 

// Semplici immagini - Esempio 29-3 



if ( I isset ( $_POST [' scale ']) ) 

Sscale = 0; 
else 

Sscale = $_P0ST[ 'scale']; 
if ($scale < 0) 

$scale=0; 
elseif (Sscale >= 100) 

$scale=400; 
else 



, "r ~ — ■ 
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$scale=$scale*4; 

echo("<img src='graphics/bluesquare. jpg 1 width=' Sscale ! height=' 10' >" ) : 

?> ■ ' : ■' ■ ' 

<br><img src= ' graphics/barscale . j pg ■ > 

Il programma inizia richiedendo la creazione di due immagini. La prima è barsca- 
le.jpg, una semplice scala numerica. La seconda immagine è un quadrato blu 10 x 
10 pixel, Queste immagini sono rappresentate nella Tabella 29.2. 



Tabella 29.2 


Immagini della barra 














25 


SO 


TS 100 


Barscale.jpg 


\ 


■ 




Bluesquare.jpg 



Quesf ultima immagine è quella che sarà utilizzata per creare la barra sulla scala. Da 
un'analisi dello script, si può notare che la prima sezione visualizza il modulo in cui 
Pulente inserisce il valore da visualizzare- 

<h2>Semplice indicatore a barre</h2> 

<form action='<?php echo($_SERVER[ 1 PHP_SELF' ] ) ; ?>' method='post'> 

Inserire un numero compreso tra 0 e 100: <input type='text' name=' scale '> 
inPu^type» -subn.it'> 



La sezione successiva controlla che i valori inseriti siano compresi tra 0 e 100 e, in 
caso negativo, li imposta a 0 o 400; poiché la scala è larga 400 pixel, infatti, la barra 
deve essere larga 400 pixel per rappresentare il 100%: 



if ( ! isset ($_P0ST[ 'scale' ] )) 

Sscale = 0; 
else 

Sscale = $_P0ST[ 1 scale ' ] ; 
if (Sscale < 0) 

$scale=0; 
elseif (Sscale >= 100) 

$scale=400; 



Se il valore inserito nel modulo è compreso tra 0 e 100, esso viene moltiplicato per 
4 in modo da essere rappresentato sulla scala: 

else 

$scale=$scale*4; 

Quindi viene visualizzata l'immagine del quadrato blu, la cui larghezza è stata adat- 
tata al valore di Sscale: 

echo("<img src='graphici/bluMquare. jpg' width=' Sscale' height= 1 10' >" ) ; 
Infine, compare l'imnuxlnc -I. IL. burnii 
<br><img sre- graphloa/bar 



linux- di scala .simili sono mollo impiegate nelle panine Web pei rappresentare in 
veste grafica i dati Ottenuti da database o file. La nanna dm. uni. .1 ilei grafici permet- 
te all'immagine di fornire un quadro aggiornato dei dati. 



Riepilogo 

Questo capitolo ha mostrato ciò che PHP è in grado di ottenere manipolando im- 
magini già esistenti. 

Anche se gli esempi proposti sono abbastanza banali, in realtà possono essere di 
grande effetto. Il prossimo capitolo approfondirà l'argomento della manipolazione 
di immagini e presenterà la libreria GD di PHP, che consente di creare immagini da 
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La librerìa GD 



■ 
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maggior parte delle pagine Web contiene immagini utilizzate per migliorare 
l'aspetto e la fruizione delle pagine stesse. Nel capitolo precedente si è visto che 
PHP può essere utilizzato per manipolare immagini esistenti; tuttavia i progettisti 
Web devono prestare attenzione nell'utilizzo delle immagini, poiché un abuso di 
grafica può infastidire gli utenti e ridurre pertanto l'accessibilità. PHP ha una libreria 
di funzioni che consente di creare e manipolare immagini. Con PHP, creazione e vi- 
sualizzazione delle immagini possono avvenire utilizzando un numero molto ridot- 
to di righe di codice. In questo capitolo verranno introdotte alcune librerie di fun- 
zioni disponibili, tuttavia dovete ricordare ciò che si è detto sulla prudenza nel ri- 
corso alle immagini. Il semplice fatto che PHP offra strumenti per creare e manipo- 
lare le immagini non significa che dobbiate abusarne. 

Come procurarsi la libreria GD 

Le funzioni per la manipolazione delle immagini di PHP sono fornite dalla libreria 
GD, che ora viene fornita come standard con l'installazione di PHP per MS Win- 
dows (supponendo che abbiate scaricato il pacchetto zip binario e non il file di in- 
stallazione più piccolo). Dovrete tuttavia modificare il file php.ini per attivarla. Que- 
sto file si trova nella directory c:\ivindows\ o c:\winnt di un sistema Windows. Per 
attivare la libreria GD dovete aprire il file php.ini in un editor come Blocco note e 
poi trovare la riga seguente nel file: 

; extension=php_gd2 . dll 

Per attivare la libreria è sufficiente rimuovere il ; dall'inizio della riga e salvare il fi- 
le, La Figura 30.1 illustra il file php.ini visualizzato in Blocco note. Dovrete anche, 
accertarvi che la directory cvlfiisioiis punti al percorso del file gd2.dll sul vostro 
computer. Nell'esempio di questo libro è il seguente: 



extension_dir = "e: \php\«xton»lont\* 



Fila 



Modifica 

IT. — 



or 



; extensi on=php_bz2. dll 
; extensi on=php_cpdf . dll 
; extensi on=php_crack. dll 
; extensi on=php_curl . dll 
; extension=php_db.dll 
; extension=php_dba. dll 
;extension=php_dbase.dll 
; extension=php_dbx.dll 
; extensi on=php_dortixml. dll 
; extensi on=php_exif . dll 
; extensi on=php_f df . dll 
extensi on=php_fi lepre dll 



; extension=php_gettext.em 
; extension=php_nyperwave. dll 
; extension=php_iconv.dll 
; extensi on=php_if x. dll 
; ext ensi on=php_i i sf une. di 1 
; extensi on=php_imap. dll 
; extensi on=php_i nterbase. di 1 
; extensi on=php_i ava. dll 
; extensi on=php_l dap. dll 
; ext ension=php_jnbst ring. dll 
; ext ens i on=php_mcrypt . di 1 
; ext ensi on=php_itihash. dll 
; extension=php_niimejagic.dn 
; extensi on=php_ming. dll 
; ext ensi on=php_mssql. dll 
; extensi on=php_msql . dll 
; extensi on=php_oci 8. dll 
; extension=php_openssl.dll 
; extensi on=php_oracl e. dll 
; extensi on=php_pdf . dll 
;extension=php_pgsql .dll 





Figura 30.1 

Il file php.ini. 



Versioni della libreria GD 



Le prime versioni della libreria GD offrivano il supporto per la creazione di immagi- 
ni nei formati JPEG (Joint Photogmphics Experts Group) e GIF (Graphic Interchange 
Formai). Tuttavia, a causa della controversia legale relativa alla proprietà del forma- 
to GIF, le versioni più recenti della libreria GD hanno rimosso il supporto per la 
creazione di immagini di questo tipo, introducendo al suo posto il supporto per le 
immagini PNG (Portable Network Graphics), un formato di file progettato per la gra- 
fica Web. Questo capitolo si concentrerà sulla creazione di immagini JPEG e PNG. 



Creazione di una semplice immagine JPEG 

Si comincerà illustrando come creare un'immagine JPF.C ". m< ili" semplice. A tal fine 
è necessario introdurre diverse funzioni della libreria GD, la prima delle quali è 
ImageCreate( ). 
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La sintassi della funzione è la seguente. 



int ImageCreate(int x, int y) ; 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


X 


int 


Larghezza dell'immagine in pixel. 




int 


Altezza dell'immagine in pixel. 


Restituzione di imageCreate ( ) 


int 


La funzione ImageCreate ( ) restituisce un 






valore intero che viene utilizzato per memo- 






rizzare l'handle dell'immagine. 



Esempio di funzione: 

Situale = ImageCreate (100, 100) ; 



Questa istruzione creerà un'immagine di dimensioni di 100 x 100 pixel. La funzione 
successiva è ImageColorAllocate ( ) . 
La' sintassi della funzione è la seguente. 

int ImageColorAllocate (int immagine, int rosso, int verde, int blu); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


immagine 


int 


Handle dell'immagine ottenuto dalla funzione 
ImageCreate(). 


rosso 


int 


Valore che specifica la quantità di rosso utilizza- 
ta per formare il colore. I valori sono compresi 
tra 0 e 255. 


verde 


int 


Valore che specifica la quantità di verde utilizza- 
ta per formare il colore. I valori sono compresi 
tra 0 e 255. 


blu 


int 


Valore che specifica la quantità di blu utilizzata 
per formare il colore. I valori sono compresi tra 
0 e 255. 


Restituzione di 


int 


Restituisce un identificatore di colore al colore 


imageColorAllocate ( ) 




specificato. 



Esempio di funzione: 

$red = ImageColorAllocate($image,255,0,0) ; 

Questo esempio crea il colore rosso, che viene memorizzato nella variabile $red 
Poi è possibile utilizzare la funzione ImageFill() per "riempire" l'immagine con 
un colore particolare. 
La sintassi della funzione e la segiic-nie, 

int ImageFilKint immutu»», uh >, int y, int colore); 
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La tabella sogucnlc descrive ^li argomenti e il tipo eli vaioli' restili dalla funzione. 



Nome Tipo Descrizione 



immagine int Handle dell'immagine ottenuto dalla funzione 

ImageCreate(). 

x int La coordinata X per l'inizio del riempimento. 

y int La coordinata Y per l'inizio del riempimento. 

colore int II colore da utilizzare. Questo valore viene rice- 

vuto dalla funzione ImageColorAllocate. 

Restituzione di imageFill ( ) int Restituisce 1 (TRUE) se va tutto bene o 0 (FAL - 

SE) se si verifica un errore. 

Esempio di funzione: 
ImageFill ($image,0,0,$red); 

Questo esempio riempirà l'immagine $image a partire dal suo angolo superiore si- 
nistro con il colore specificato con la variabile $red. 

A questo punto siete pronti per creare e memorizzare l'immagine. A tal fine utilizze- 
rete la funzione ImageJPEG ( ) . 
La sintassi della funzione è la seguente. 

Int ImageJPEG(int immagine, string nomefile); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome Tipo Descrizione 



immagine int Handle dell'immagine ottenuto dalla funzione 

imageCreate. 

nomefile string II nome del file dell'immagine. 

Restituzione di imageJPEG( ) int Restituisce 1 (TRUE) o 0 (FALSE) a seconda che 

la funzione abbia avuto o meno successo. 

Esempio di funzione: 

ImageJPEG($image, 'quadratorosso. jpeg 1 ) ; 

Questo esempio creerà un'immagine chiamata quadratorosso.jpeg. Infine viene uti- 
lizzata la funzione ImageDestroy( ) per liberare la memoria sfruttata nella genera- 
zione dell'immagine. 
La sintassi della funzione è la seguente. 

int ImageDestroy(int immagine); 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 
Nome Tipo Descrizione 



immagine int Handle dell'immagine ottenuto dalla funzione 

ImageCreate(). 

Restitu/innc di int Restituisce 1 (TRUE) <» 0 (FALSE) a seconda che 
imageDestroyO la funzione abbia avuto ■> meno successo. 



Esempio di funzione: 
ImageDestroy($image) ; 

Lo script che segue utilizza tutte queste funzioni insieme, per produrre una sempli- 
ce immagine. 



<?php 



// Immagini GD - Esempio 30-1 

/./ : "' ' • <;•■: 

MS '■'"' '* i \ * 



Simage = ImageCreate (100, 100) ; 
$red =ImageColorAllocate($image,255,0,0) ; 
ImageFill ($image,0,0,$red) ; 

;s:|:s^sis; 9 e?r hlcs " ,uadr " orosso ' ipe9 ' ,i 

7 

/ 

«imo/ src= 1 graphics/quadratorosso . j peg ' > 

ByfT ;<", ■ 1 < 

L'output di questo script produce qualcosa di simile a ciò che è illustrato nella Figu- 
ra 30.2. 

:. -Mal 
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MI ! iB; i "I i Ig'intraneFiocale ' ~ j 

Figura 30.2 

Una semplice immagine JPEG. 



Se controllate la directory del server Web che contiene i file .php, vedrete che con- 
tiene un'immagine chiamata quadratorosso.jpeg. Questa immagine viene visualizza- 
ta sulla pagina Web grazio all'elemento HTML <img src="quadratoros - 
80. jpeg">. L'immagine generala puù essere visualizzata e modificata con un qua- 
lunque programma di manipolazioni grafica 



352 Capitolo 30 



Creazione di una semplice immagine PNG 

Il programma PHP precedente dà vita a un'immagine JPEG. Qualora vogliate creare 
un'immagine PNG, il programma sarebbe molto simile: cambia soltanto una riga di 
codice, in quanto è necessario utilizzare la funzione ImagePNG( ). 
La sintassi della funzione è la seguente. 

Int ImagePNG(int immagine, string nomefile); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nom e Tipo Descrizione 



immagine 


int 


Handle dell'immagine ottenuto dalla funzio- 
ne ImageC re at e (). 


nomefile 


string 


Il nome del file di immagine. 


Restituzione di imagePNG( ) 


int 


Restituisce 1 (TRUE) 0 0 (FALSE) a seconda 
che la funzione abbia avuto o meno successo. 



Esempio di funzione: 

ImagePNG($image, 'rettangologiallo.png ) ; 

Questa istruzione creerà un'immagine di nome rettangologiallo.png. Per dar vita a 
un rettangolo giallo è necessario cambiare la funzione ImageCreate( ) in modo 
che non crei un quadrato. L'esempio che segue genera un'immagine di dimensioni 
200 x 100 pixel: 

$image = ImageCreate (200,1 00) ; 

Occorre anche creare il colore giallo con la funzione ImageColorAllocate ( ): 
$yellow = ImageColorAllocate (Simage, 255, 255, 0) ; 
Infine è necessario riempire l'immagine con il colore giallo: 



ImageFill ($image ,0,0, $y ellow) ; 
Lo script ha il seguente aspetto: 
< ? php 

// Immagini GD - Esempio 30-2 
// 

Simage = ImageCreate(200, 100) ; 

Syellow = lmageColorAllocate($image, 255, 255,0) ; 

ImageFill($image,0,0,$yellow) ; 

ImagePNG($image, 'graphics/rettangologiallo.png' ) ; 
ImageDestroy($image) ; 

?> 

<img src= ' graphics/ rettangologiallo . png ' > 

La visualizzazione ddl'oulpul di quosio .script in un hi..v ■ i dovrebbe produrre 
(iiutlcosa ili -.nuilc .i citiamo Illustrato nella Pigimi vi \ 
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Figura 30.3 

U/ia semplice immagine PNG. 



Un esame della director,' Web contenente le immagini confermerà la presenza di 
un file di nome rerranoolnoifllln nno 



Disegno di rettangoli e quadrati 

La libreria GD contiene due funzioni che permettono di creare rettangoli e quadrati 
sulle proprie immagini: sono le funzioni ImageFilledRectangle( ) e Image- 
Rectangle ( ) , che consentono la creazione di un rettangolo o quadrato pieno e di 
un contorno rettangolare o quadrato. 
La sintassi delle funzioni è riportata di seguito. 

Int ImageFilledRectangle(int immagine, int x1, int y1, int x2, int y2, int 
co2.opq} J 

Int ImageRectangle(int immagine, int x1, int y1 , int x2, int yà, int 
colore) ; 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 




Tipo 



Descrizione 



int 
int 
int 
int 
int 



colore 
Restituzione di 
imageFilledRectongU ( ) 

'■ lHKi(iH1.!c;l;in| 



Handle dell'immagine ottenuto dalla funzione 
ImageCreate( ). 

La coordinata X dell'angolo superiore sinistro 
del rettangolo. 

La coordinata Y dell'angolo superiore sinistro 
del rettangolo. 

La coordinata X dell'angolo inferiore destro del 
renandolo. 

Lu coordinata Y dell'angolo inferiore destro del 

rettangolo, 

' olore del rettangolo. 

ReaUtulMcono 1 <true) <i0<false) a seconda 

Itinxlonc ubbia avuto o meno sui i csno 
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Esempio di l'un/.ii me: 

ImageFilledRectangle (Simage, 20, 20, 50, 50, $red); 
ImageRectangle($image, 100, 20, 150, 150, $blue) ; 

Lo script che segue utilizza queste due funzioni per creare un'immagine che contie- 
ne un rettangolo e un quadrato. 

<?php 

// immagini SD - Esempio 30-3 



Simage = ImageCreate(200,200) ; 
Syellow = imageColorAllocate (Simage, 255, 255,0); 
$red = lmageColorAllocate($image,255,0,0) ; 
Sblue = imageColorAllocate (Simage, 0,0, 255) ; 
ImageFill (Simage , 0 , 0 , Syellow) ; 

ImageFilledRectangle( Simage, 20, 20, 50, 56, Sred); 
ImageRectangle($image, 100, 20, 150, 150, Sblue); 
ImagePNG( Simage, 'graphics/rettangoli. png' ) ; 
ImageDestroy (Simage); 

• . „,■■••■.•■: «Vi. 

<img src='graphics/rettangoli.png > 

La visualizzazione dell'output di questo script dovrebbe produrre qualcosa di simile 
a quanto mostrato nella Figura 30.4. 



'1 h»p:/V'localh06t/phpbook/esempio30-3.php - Microsoft Internet : r-xplorer 
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Figura 30.4 

Rettangoli e quadrati, 
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Disegnare righe continue 

la funzione ImageLine( ) offre un mezzo per disegnare righe dritte sulle immagini. 
La sintassi della funzione è la seguente. 

Int ImageLine(int immagine, int x1 , int y1, int x2, int y2, int colore); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


immagine 


int 


Handle dell'immagine ottenuto dalla funzione Imaqe- 






Create(). 


in 


int 


La coordinata X dell'angolo superiore sinistro della riga. 




int 


La coordinata Y dell'angolo superiore sinistro della riga. 


X2 


int 


La coordinata X dell'angolo inferiore destro della riga. 


y2 ll 


int 


La coordinata Y dell'angolo inferiore destro della riga. 


colore 


int 


Colore delle riga. 


Restituzione di 


int 


Restituisce 1 (TRUE) o 0 (FALSE) a seconda che la fun- 


imàgeLine( ) 




zione abbia avuto o meno successo. 



Esempio di funzione: 

ImageLine ( Simage , 1 0 , 1 0 , 50 , 50 , $red ) ; 



Considerate lo script seguente: 

■ 

<?php 

// Immagini GD - Esempio 30-4 



Simage = imagecreate(101 , 101 ) ; 
Syellow = ImageColorAllocate($image, 255, 255,0); 
Sblack = ImageColorAllocate( Simage, 0,0,0) ; 
ImageFill($image,0,0,$yellow) ; 
for(Sx=0;$x<=100;$x+=10) { 

ImageLine (Simage , $x , 0, $x , 100 , Sblack) ; 

for($y=0;$y<=l00;Sy+=10) { 

ImageLine ( Simage , 0 , $y , 1 00 , $y , Sblack ) ; 

ImagePNG( Simage, 'graphics/grigliagialla. png ' ) ; 
ImageDestroy (Simage) ; 

Hp 

<img src='graphics/grigliagialla.png'> 

Lo script illustra un esempi, i .li utilizzo della funzione ImageLine ( ). Esaminando- 
lo in modo piti ckMiaj-li.ii. . m ih .la die viene creata un'immagine di 101 x 101 pixel e 
vengono definiti due . . .1. m Minilo c nero 

Simage = imagecrento( ibi , tei i, 
Syellow = ImaQeColorAl i». muftì' .'v,,oi ; 

Sblack - Imago-Co lorAi i... »i«»é^t ll f t f r Bi 
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Poi l'immagine viene riempila con il colore giallo: 
ImageFill($image,0,0,$yellow) ; 

Le righe di codice successive utilizzano un ciclo f or per creare 11 righe che appaio- 
no dall'alto verso il basso dell'immagine, staccate di 10 pixel: 

for($x=0;$x<=100;$x+=10) { 

ImageLine ($image, $x , 0 , $x , 1 00 , Sblack) ; 

} 

Le righe di codice successive creano 11 righe da sinistra a destra dell'immagine, 
staccate di 10 pixel: 

for($y=0;$y<=100;$y+=10) { 

ImageLine ($image,0,$y , 100, $y ,$black) ; 

U'. ■ . .. . ■ ' " ' 

Infine l'immagine viene salvata, la memoria utilizzata per la sua creazione viene ri- 
lasciata e l'immagine viene visualizzata: 

ImagePNG($image, 'graphics/grigliagialla.png' ); 
ImageDestroy($image) ; 

<img src= ' graphics/grigliagialla. png 1 > 

L'output prodòtto da questo programma è quello della Figura 30.5. 
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Figura 30.5 

Disegnare righe continue. 



■ 




Intranet locale 



Disegno di righe tratteggiate 

l'un/inii.- liii.ui.'!;i>i:;tyle() viene utilizzata in combinazione con la l'unzione 
Imagel in<M ) |"i -I. •• riverì' il l'< >mi;im della riga. 
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La sintassi della l'unzione è la seguente. 

Int ImageSetStyle(int immagine, array stile); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 

. , 

Nome Tipo Descrizione 



immagine int Handle dell'immagine ottenuto dalla funzione 

ImageCreate(). 

stIie array Array di pixel che descrivono la riga. 

3S2££52S d Ì , » int Restituisce 1 (TRUE) o 0 (FALSE) a seconda che 

imageaetbtyieQ . la funzione abbia avuto o meno successo. 

Esertopio di funzione: 

ImageWtStyle (Simage, $style); 

Lo script che segue offre un esempio di utilizzo di questa funzione. 
<?p , hp 



// Immagini GD - Esempio 30-5 
$image = imagecreate(100, 100) ; 

Slightblue = ImageColorAllocate($image,64,64,255) ; 
Swhite = ImageColorAllocate($image,255,255,255); 
ImageFill($image, 0,0, Slightblue); 

$style = array ($white, Slightblue); 

ImageSetStyle($image,$style) ; 
ImageLine (Simage, 10, 50, 90, 50, IMG_C0L0R_STYLED) ; 
ImageLine ( $image , 50 , 1 0 , 50 , 90 , IMG_C0L0R_STYLED) ; 
ImagePNG( Simage, 'graphics/tratteggioblu.png' ) ; 
ImageDestroy(Simage); 

<img src=' graphics/tratteggioblu.png^ 

Osservate che $style è definita come semplice array di punti alternati bianchi e blu- 
Sstyle = array (Swhite, Slightblue); 
Questo viene poi definito come stile: 
ImageSetStyle($image, Sstyle) ; 



Infine viene chiamata la funzione ImageLine ( ) , che è in grado di utilizzare lo stile 
definito attraverso la costante IMG_C0L0R_STYLED: 

ImageLine($imiigo, IB,oO,mi,fi0, IMO COLOR STYLED) ; 
ImageLine ( Simnoo , 0« , l e , ne , OB , IMQ~C0L0RlsTYLED) ; 

La Figura M) (> iII.i-.im I iiul|iul |NuikMlu Ua quatto script, 
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Figura 30.6 

Disegnai righe atteggiate. 



Inserimento di testo 



La libreria GD supporta funzioni che consentono di inserire tesco in un'immagine. Si 
tratta della funzione ImageString ( ), che permette l'inserimento di testo da sinistra 
a destra, e della funzione ImageStringUp( ), che consente di inserire testo dall'alto 
in basso. 

La sintassi delle funzioni è riportata di seguito. 

Int ImageString(int immagine, int dimensione, int x, int y, string testo, 
int colore) ; 

Int ImageStringUp(int immagine, int dimensione, int x, int y, string 
testo, int colore); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 



Tipo 



Descrizione 







immagine 

dimensione 
x 



testo 
colore 



int 



Restituzione di imageString ( ) int 
e imageStringUpO 



Handle dell'immagine ottenuto dalla fun- 
zione ImageCreate () . 
int La dimensione del testo da visualizzare. 

La coordinata X dell'angolo superiore sini- 
stro del testo. 

La coordinata Y dell'angolo superiore sini- 
stro del testo. 
Il testo da visualizzare. 
Colore del rettangolo. 
Restituisce 1 (TRUE) o 0 (FALSE) a secon- 
da che la funzione abbia avuto o meno 



int 
int 

string 
int 



SUCCCSS( >. 



[•'sciupio ili l'un/iotu.': 

ImageString($image l 4 l 10 l 10 I "Ciao" , $white) ; 



Lo scripi seguente illustra un esempio di utilizzo di questa funzione. 
<?php 

Esempio 38-6 



// Immagini GD 

//■■- 

$image = imagecreate(100, 100) ; 
Sdarkred = ImageColorAllocate($image,192,0,0) ; 
$white = ImageColorAllocate($image,255,255,255) ; 
ImageFill($image,0,0,$darkred) ; 
ImageString($image,4,10,10, "Ciao, " , $white) ; 
ImageString ($image, 3, 10,25, "io" , $white) ; 
ImageString ($image, 2, 10,40, "ni" , $white) ; 
ImageString ($image,1 ,10,55, "chiamo" , $white) ; 
ImageString($image,5,10,65, "Simon" , $white); 

Si?**'''-."'/ ' 

src= ' graphics/testorosso . png 1 > 

.- 

La Figura 30.7 illustra l'output prodotto da questo script. 
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Figura 30.7 

Testo sull'immagine, 




illustra un esempio di utilizzo di questa funzione: 
<?php 

// Immagini GD • Esempio 30-7 

// 

Simage = imaatcru.it «( laa, 100) ; 

Sdarkred - XnmgtOolOI «1 i, ) ente($image l 192,0,0) ; 



jou capitolo ju 



Swhite = ImageColorAllocate (Simage, 255, 255,256) ; 

ImageFill (Simage, 0,0,$darkred); 

ImageSt ringUp (Simage , 4 , 20 , 90 , " Ciao " , $wh ite ) ; 

imageSt ringUp ( Simage , 4 , 40 , 70 , " Simon " , Swhite ) ; 

lmagePNG($image, 'graphics/testorossovert.png' ) ; 

ImageDestroy(Simage); 

?> 

<img src= ' graphics/testorossovert . png ' > 

La Figura 30.8 illustra l'output prodotto da questo script. 
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Figura 30.8 

Testo sull'immagine in verticale. 



I 



Visualizzazione di singoli caratteri 

"' ...... . . 1 , ,)''„: '.< ■"■ 

Oltre alla possibilità di visualizzare stringhe di caratteri, esistono due funzioni con- 
cepite per visualizzare caratteri singoli. Si tratta delle funzioni ImageChar ( ) e 
ImageCharUp( ), che operano esattamente come le funzioni ImageString( ) e. 
ImageStringUp( ). 

La sintassi delle funzioni è riportata di seguito. 

Int ImageChar (int immagine, int dimensione, int X, iflt y, char carattere, 
int colore) ; 

Int ImageCharUp(int immagine, int dimensione, int x, int y, char 
carattere, int colore) ; 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle funzioni. 



Nome 


Tipo 


Descrizione 


immagine 


int 


Handle dell'Immagine («tenuto dalla funzione 






ImageCreato( ) 


dimensione 


int 


La dimensioni' del . ttr.Utere da visualizzare. 
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Nome 



Tipo 



Descrizione 



x 

y 



int 
int 



carattere char 

colore int 

Restituzione di imageChar( ) int 
e imageCharUp() 



Esempio di funzione: 



La coordinata X dell'angolo superiore sinistro 
del carattere. 

La coordinata Y dell'angolo superiore sinistro 
del carattere. 

Il carattere da visualizzare. 
Colore del rettangolo. 

Restituisce 1 (TRUE) o 0 (FALSE) a seconda 
che la funzione abbia avuto o meno successo. 



ImageChar (Simage, 4, 20, 70, "H", Swhite); 
ImageCharUp($image,4,40,40, "S" , Swhite) ; 

Lo scripj) seguente illustra un esempio di utilizzo di que 
<?ph P/ 



///Immagini GD - Esempio 30-8 



1 ' 



■ 



Simage = imagecreate (100,1 00 ) ; 
Sblack = InageColorAllocate($image, 0,0,0) ; 
Swhite = ImageColorAllocate($image,255,255,255); 
ImageFill($image,0,0,$black) ; 

sasttssr+rss!., 

ImagePNG($image, 'graphics/caratterenero.png' ) ; 
ImageDestroy (Simage) ; 



?> 



<img src= 1 graphics/caratterenero . png 1 > 



La Figura 30.9 illustra l'output prodotto da questo script. 



■ 
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Figura 30.9 

Visualizzazione di singoli catturi 



Altezza e larghezza dei font 



I font di diverse dimensioni, ovviamente, hanno larghezze e altezze diverse, e i font 
utilizzati nella libreria GD non fanno eccezione. La libreria GD ha due funzioni, uti- 
lizzabili per determinare la larghezza e l'altezza del font: ImageFontWidth ( ) e 
ImageFontHeight{). 

La sintassi delle funzioni è riportata di seguito. 



int ImageFontWidth (int font); 
int ImageFontHeight(int font); 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalle funzioni. 



Nome 


Tipo 


Descrizione 


font 

Restituzione di 
imageFontWidth() e 
imageFontHeight( ) 




La dimensione del fonc che viene controllata, per 
determinarne l'equivalente in pixel. 
Entrambe le funzioni restituiscono un valore in- 
tero, che rappresenta la larghezza o l'altezza del 
font in pixel. 


Esempi di funzioni: 







$height = ImageFontHeight(4) ; 
Swidth = ImageFontWidth ( 4); 

Lo script seguente illustra un esempio di utilizzo di questa funzione. 
<?php 



// Immagini GD 

I 



Esempio 30-9 



Simage = imagecreate (300,1 00) ; 

Slightgrey = ImageColorAllocate($image, 192,192,255) ; 
Sdarkgreen = ImageColorAllocate($image, 0, 192,0) ; 
ImageFill (Simage ,0 , 0 , $lightgrey ) ; 
Sheight = ImageFontHeight(4) ; 
Swidth = ImageFontWidth (4) ; 

$text = "L'altezza di questo testo e' " . Swidth; 
$text2 = "La larghezza di questo testo e 1 " . Sheight; 
ImageString($image,4,10,20,$text, Sdarkgreen) ; 
ImageString($image,4, 10,50,$text2, Sdarkgreen) ; 
ImagePNG($image, 'graphics/altezzafont.png' ); 
ImageDestroy (Simage) ; 

?> 

<img src=' graphics/altezzafont.png '> 
La Figura 30.10 illustra l'output prodotto da questo script. 

Conoscere l'altezza o la larghezza del testo che visualizzale consente di collocare il 
testo esali. mi. ni. il . miro dell'immagine. Nel prossimo paragrafo vedrete un esem- 
pio di quanto appena affermato. 
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Figura 30. IO 

Visualizzazione della larghezza e dell'altezza del testo. 



Testo-centrato 



5 



Una frequente applicazione delia funzione ImageFontWidth ( ) è il posizionamento 
del testo esattamente al centro dell'immagine. 

Considerate lo script seguente, che illustra come agire per centrare il testo. 



<?php 

// Immagini GD - Esempio 30-10 

// 



■ 



Simage = imagecreate (300, 108) ; 
Sblue = ImageColorAllocate($image,0,0,255); 
Svellow = ImaneOnlorAllonatfiiSimanfi.PFifi. PRfi.CH r 



Syellow = ImageColorAllocate($image,255,^,» ; , 
ImageFill($image, 0,0, Sblue) ; 
Stext = "Esempio di testo centrato"; 
Swidth = ImageFontWidth (4) * strlen(Stext) ; 
Sx = (300 - Swidth) 12; 

ImageSt ring (Simage, 4, $x, 40, Stext, Syellow) ; 
ImagePNG(Simage, 'graphics/fontcentre.png' ) ; 
ImageDestroy(Simage) ; 



?> 

<img src= 1 graphics /f ontcent re . png 1 > 



Esaminate le parli Importanti di questo script, che permettono di centrare il testo. 
Per prima cosa, il leslo da visualizzare viene memorizzato nella variabile stringa 
$text: 



Stext = "Esempio di tetto contrito* ì 

( Ivviaincnic pi ih i. >n 
glie/.za ilei foni con In 



Ovviamente pou-ir unii, . il umo • In pri Intle Li riga successiva calcola la lai 
I»ii/m>ii< t«»MU»ro*t|«Vl<ltti( ) >• moltiplica qurslo valore pei 



il numero di caratteri presemi nella stringa, ottenuto con la lun/ione strlen{). 
Questo valore viene memorizzato nella variabile Swidth: 

$width = ImageFontWidth(4) * strlen(Stext) ; 

La variabile $width ora conosce esattamente la lunghezza in pixel dell'intera strin- 
ga. È quindi necessario determinare dove collocarla nell'immagine in modo da cen- 
trare il testo. A tal fine occorre conoscere la larghezza dell'immagine, che in questo 
caso è 300 pixel. La larghezza del testo già è nota, quindi l'unica operazione che ri- 
mane da compiere è dividere per due la differenza tra i due valori, per essere certi 
che il testo sia collocato al centro dell'immagine. La Figura 30.11 illustra quanto ap- 
pena affermato. 
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Figura 30. Il 

Testo centrato. 











Per calcolare la posizione centrata si sottrae la larghezza del testo (Ldt) dalla lar- 
ghezza dell'immagine (Ldi) e si divide il risultato per due. Il codice per calcolare la 
posizione della coordinata X è il seguente: 



$x = (300 - $width)/2; 



La Figura 30.12 illustra l'output prodotto da questo programma. 



Creazione di poligoni 



Oltre a semplici rettangoli e quadrati, la libreria GD offre il supporto per la creazio- 
ne di poligoni più complessi. A tal fine si utilizza la funzione ImagePolygon( ) . 
La sintassi della l'unzione è la seguente. 

int ImagePolygon(int immagine, array punti, int numero, int colore); 
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La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 



Tipo 



Descrizione 



immagine 


int 


Handle dell'immagine ottenuto dalla funzione 
lmageCreate( ). 


punti 


array 


L'array che memorizza i punti dell'immagine. 


numero 


int 


Il numero di punti che realizzano il poligono. 
Il colore del poligono. 


colore 


int 


Restituzione 


int 


Restituisce 1 (TRUE) o 0 (FALSE) a seconda 


di imagePolygon( ) 




che la funzione abbia avuto o meno successo. 



Esempio di funzione: 

$C00rdS =array (0,50, 35, 35, 50, 0,65, 35, 100, 50, 65, 65, 50, 100, 35, 65) ; 
ImagePolygon (Simage, $coords , 8 , Syellow) ; 

In questo esempio il poligono è costituito da otto punti che sono 
nell'array $coords come otto coppie di valori X-~" 
esempio di utilizzo di questa funzione. 




<?php 

// Immagini 6D - Esempio 30-11 

Wk 



Simage = imagecreate (100,1 00 ) ; 
Sblue = ImageColorAllocate($image,0,0,255) ; 
Syellow = ImageColorAllocate($image, 255, 255,0) ; 
ImageFill ( Simage , 0 , 0 , Sbluo ) ; 

Scoords = array (0,68,36,36,66, 0,88, 35 ,100, 50, 65, 65, 50, 100, 35, 65) ; 
ImagePolygon (Simngo.lcoo. Ll0W)| 
ImagePNG($image, -gi-aphlvt/atol U pnQ ); 
lm,'K|0l><>sl i-ov(:i. umili" | , 



?> 

<img src='graphics/stella.png'> 




Figura 30. 13 

Creazione di un poligono. 



Riempimento di forme 

Potreste voler creare un poligono come quello dell'esempio precedente che non sia 
un semplice contorno, ma una figura piena. Sfortunatamente non esiste una funzio- 
ne ImagePolygonFilled ( ) , tuttavia avete a disposizione qualcosa di molto simile: 
la funzione ImageFillToBorder(). Questa funzione consente di riempire parte di 
un'immagine con un colore. Un cambiamento del colore di sfondo dell'immagine 
indica in che misura avverrà il riempimento di colore. 
La sintassi della funzione è la seguente. 

Int ImageFilledToBorderfint immagine, int x, int y, int coloreBordo, int 
colore) ; 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


immagine 


int 


Handle dell'immagine ottenuto dalla funzione 






ImageCreate(). 


X 


int 


La coordinata X dell'inizio del riempimento. 


y 


int 


La coordinata Y dell'inizio del riempimento. 


coloreBordo 


int 


Il colore del bordo in corrispondenza del quale 






interrompere il riempimento. 


colore 


int 


Colore del riempimento. 


Restituzione di 


int 


Restituisce 1 (TRUE) 0 0 (FALSE) a seconda che- 


imaoeFilledToBordor() 




la l'unzione iihliln uvuio o meno successo. 







Esempio di l'unzione: 

ImageFillToBor-der($image , 50 , 50 , Syellow, $red ) ; 

Osservate che in questo esempio il poligono verrà riempito con il colore giallo, 
mentre il bordo del poligono sarà rosso. Lo script che segue illustra un esempio di 
utilizzo di questa funzione. 

// Immagini GD - Esempio 30-12 

//--- 



<?php 



Simage = imagecreate(100, 100) ; 
Sblue .= ImageColorAllocate($image,0,0,255) ; 
Syellow = ImageColorAllocate (Simage, 255,255, 0) ; 
$red = ImageColorAllocate ($image,255, 0, 0) ; 
ImageFÌll($image, 0,0, Sblue) ; 

$000/dS = array(0, 50, 35, 35, 50, 0,65, 35, 100, 50, 65, 65, 50, 100, 35,65) ; 
ImagePolygon (Simage , Scoords , 8 , Syellow) ; 
ImageFillToBorder ( Simage , 50 , 50 , Syellow , Sred ) ; 
ImagePNG($image, 1 graphics / stellariempita. png 1 ) ; 
ImageDestroy (Simage) ; 
• 

<img src='graphics/stellariempita.png'> 

La Figura 30.14 illustra l'output prodotto da questo script. 
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Figura 30. 14 

Poligono riempito. 



Creazione di nuove immagini 
a partire da quelle esistenti 

Quando utilizzate la libreria GD, non siete costretti a cominciare a creare le immagi- 
ni da zero: potete anche caricare un'immagine esistente e modificarla. PHP offre il 
supporto per tre formati di immagine diversi (JPEG, GIF e PNG) rispettivamente 
con le funzioni ImageCreateFromJPEG( ), ImageCreateFromGIF( ) e ImageCre- 
ateFromPNGf). 

La sintassi delle funzioni è riportata di seguito. 

int ImageCreateFromJPEG(string nomefile); 
int ImageCreateFromGIF(string nomefile); 
int ImageCreateFromPNG(string nomefile) ; 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalle funzioni. 



Nome 


Tipo 


Descrizione 


nomefile 

Restrizione di 
imageCreateFromGIF() 
imageCreateFromPNGf ) 
imageCreateFromJPEG( ) 


string 


Il nome del file di immagine che funge da base 
per la nuova immagine. 

La funzione restituisce un valore intero, che vie- 
ne utilizzato per memorizzare l'handle dell'im- 
magine, proprio come avviene con la funzione 
ImageCreate(). 


Esempio di funzione: 







- 

$image = ImageCreateFromJPEG( "palma. jpg" ) ;$image = 
ImageCreateFromJPEG ( " palma . j pg " ) ; 

Lo script seguente illustra un esempio di utilizzo della funzione ImageCreate- 
FromJPEG(). 

<?php 

Il Immagini GD - Esempio 30-13 



$image = ImageCreateFromJPEG( "graphics/Palma. jpg" ) ; 
$blue = imageColorAllocate($image,0, 0,255) ; 

$text = "Benvenuti ad Aruba!"; 
$width = ImageFontWidth(4) * strlen($text) ; 
$x = (300 - $width)/2; 
ImageString($image,4,$x J 330,$text J $blue); 
ImagePNG($image, ' graphics/palma. png 1 ) ; 
ImageDestroy(Simage) ; 

?> 

<img src='graphic8/palma.png'> 



La Figura 30. 1 S illustra l'i mtput prodotto da questo script, 

Ma ora che avete vl.su» i In- e possibile modificalo t iii'iim ) cikìi u - esistente, come po- 
tete sfruttale i|iiest.i . apai iti»? Troverete la risposta nel pnmimi i paragrafo. 
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Figura 30. 15 

Modifica di un'immagine esistente. . 

Creazione di pulsanti "magici" 

Questo esempio illustra come, utilizzando un'immagine esistente, è possibile creare 
nuove immagini. Il concetto di base di questo discorso è che dovete supporre di 
avere una pagina Web che offre molti pulsanti sui quali l'utente può fare clic per 
passare ad altre pagine. Immaginate ora di voler concedere agli utenti la possibilità 
di modificare il testo sui pulsanti in modo da poter personalizzare la loro visualizza- 
7.inne della naeina Web. Per fare tutto ciò dovete innanzitutto creare l'immagine di 



zione della pagina Web. Per fare tutto ciò dovete innanzitutto creare l'immagine 
un pulsante vuoto, come quello della Figura 30.16, 



[ 



Figura 30. 16 

Pulsante vuoto. 
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Poi viene creato uno script che utilizza un semplice ITI' n Lui) i per dimostrare la crea- 
zione dinamica di questi pulsanti. Lo script consente ali niente ili digitare in un cam- 
po del modulo un testo che verrà poi centrato su un pulsante. Quante più volte gli 
utenti inseriscono testo e fanno clic sul pulsante di invio, tanti più pulsanti persona- 
lizzati verranno creati. Lo script è il seguente: 

<?php 

// Immagini GD - Esempio 30-14 

// 

if (isset($_POST['text'])) 
Stext = $_POST[ 'text' ] ; 
else 

$ text = li,,,':. 

if(Iisset($_POST[ 'count'])) 

$count=1 ; 
else 

$count = $_POST[ 'count' ] ; 
if{$text == "reset") 

$count=1 ; 
else { 

Simage = ImageCreateFromJPEG( "graphics/button. jpg" ) ; 
$blue = lmageColorAllocate($image,0,e,255) ; 
$width = ImageFontWidth(4) * strlen($text) ; 
$x = (200 - $width>/2; 
ImageString($image,4,Sx,15,$text, $blue) ; 
$name = "graphics/button" . $count . ".png"; 
ImagePNG($image, $name); 
imageDestroy (Simage) ; 

| 

echo("<form method= ' post ' action='° . $_SERVER[ ' PHP_SELF ' ] . '">"); 
echo( "Inserire il testo: <input type='text' name='text'>" ) ; 
echo("<input type=' hidden ' name=' count' value='" . ++$count . "'>"); 
echo("<input type='submit'>") ; 
echo( "</form>" ) ; 
for($a=2;$a<$count;$a ++ ) 

echo("<img src=' graphics/button" . $a . ".png'>"); 

?> 

Esaminate lo script in modo più dettagliato. Le prime righe controllano il valore del 
testo utilizzato per memorizzare il testo del pulsante: 

if (isset($_POST[ 'text'])) 

$text = $ POSTI 'text' ] ; 
else 

$text = ""; 

Le righe successive verificano se la variabile $count esiste e, se non c'è, la impostano a 
1. La variabile $count viene impiegata per memorizzare la quantità di pulsanti creati: 

if(!isset($_POST[' count'])) 

$count-1 ; 
else 

Scount • MOSTI 'count' |; 



Le righe successive controllano se il valore ili $text è pari a "reset". La variabile 
Stext viene utilizzata per contenere il testo inserito tramite il modulo e per creare il 
u sto che viene collocato nel pulsante. Se l'utente digita "reset", il numero di pulsan- 
ti creati viene riportato a 1, consentendo di ricominciare: 

if($text == "reset") 
$count=1 ; 

Se il valore della variabile $text è diverso da "reset", l'immagine del pulsante viene 
Keata. 

, $image = lmageCreateFromJPEG( "graphics/button . jpg" ) ; 
$blue = ImageColorAllocate (Simage, 0,0, 255 ) ; 
$width = ImageFontWidth(4) * strlen(Stext) ; 
$x = (200 - $width)/2; 
ImageString(<$image,4,$x,15,$text, Sblue) ; 
Sname = "^/aphics/button" . Scount . ".png"; 
' ___ImageBNGt Simage, Sname); 
ImageDestroy (Simage) ; 

A questo punto viene visualizzato il modulo di input, che consente l'interazione con 
l'utente: 

echo("<form method='post' action="' . $_SERVER[ 'PHP_SELF^] . '">"); 
echo( "Inserire il testo: <input type='text' name='text'>") ; 
echo("<input type=' hidden' name='count' value="' . ++$count . '">"); 
echo("<input type='submit'>") ; 
echo(" < /for-m>") ; 

Infine il programma ricorre a un ciclo f or per visualizzare tutti i pulsanti che sono 
stati creati: 

frW!Sa=?:Sa<$coiint :Sa+-M 



f or ( $a=2 ; Sa<$count ; $a++ ) 

echo("<ing src=' graphics/button 



Sa . ".png'>"); 



La Figura 30.17 illustra un esempio di output prodotto da questo script. 
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Figura 30. 17 

Output dei pulsanti magici. 



Utilizzo di cerchi, ellissi e archi 



La funzione ImageArc ( ) può essere impiegata per produrre cerchi, ellissi, semicer- 
chi e archi. 

La sintassi della funzione è la seguente. 

int ImageArc (int immagine, int centroX, int centroY, int larghezza, int 
altezza, int gradilnizio, int gradiFine, int colore); 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 

S 

Nome Tipo Descrizione 

immagine int Handle dell'immagine ottenuto dalla funzione 

ImageCreate<). 

centroX int La coordinata X del centro del cerchio o dell'el- 

lisse. 

centroY int La coordinata Y del centro del cerchio o dell'el- 

lisse, 

larghezza int Larghezza del cerchio o dell'ellisse. 

altezza int Altezza del cerchio o dell'ellisse. 

gradilnizio int Inizia a disegnare da questi gradi. 

gradiFine int Finisce di disegnare a questi gradi. 



colore int II colore del cerchio o dell'ellisse. 

Restituzione di imageArc ( ) int Restituisce 1 (TRUE) o 0 (FALSE) a seconda che 

la funzione abbia avuto o meno successo. 



Esempio di funzione: 
ImageArc ( $image , 1 50 , 1 50 , 1 00 , 1 00 , 0 , 360 , $darkblue ) ; 

Quando si disegnano cerchi, ellissi o archi, è necessario specificare l'angolo di inizio 
(in gradi) e quello di termine. Immaginate di voler disegnare un cerchio completo. 
Ebbene, l'angolo iniziale sarebbe 0 gradi e quello finale sarebbe 360 gradi, in quanto 
ciò che volete è un cerchio completo. Qualora invece vogliate disegnare un semicer- 
chio, potreste specificare 90 gradi come angolo iniziale e 270 come angolo finale. Lo 
script che segue illustra un esempio di utilizzo della funzione ImageArc ( ). 

<?php 

// Immagini GD - Esempio 30-15 

//--■ ■ ; 



Simage = ImageCreate(300,300) ; 
Sdarkblue = ImageColorAllocate($image,0,0, 192) ; 
Swhite = lmageColorAllocate(Simage, 255,255, 255) ; 
ImageFill($image,0,0,$white) ; 

ImageArc ( Simage , 1 50 , 1 50 , 1 00 , 1 00 , 0 , 360 , Sdarkblue ) ; 
ImageArc ( Simage , 50 , 50 , 1 00 , 50 , 0 , 360 , Sdarkblue ) ; 
ImageArc ( Simage , 50 , 1 50 , 50 , 1 00 , 90 , 270 , Sdarkblue ) ; 
ImagePNG($image, 'graphics/cerchio. png' ) ; 
ImageDestroy(SiinogB) ; 



?> 

<img 8rc"'gr«phl0i/corchio.png'> 



La Figura MI IH mostra un esempio di output prodotto da questo script. 
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Figura 30. 18 

Visualizzazione di cerchi, ellissi e archi. 



Produzione di "bolle" casuali 



La funzione ImageArc ( ) può essere utilizzata per produrre effetti molto interessan- 
ti. Lo script che segue illustra un semplice esempio. 



<?php 

B ' 

// Immagini GD - Esempio 30-16 

m 

Simage = ImageCreate(300,300) ; 
Lightblue = ImageColorAllocate (Simage, 64,64, 255) ; 
blue = ImageColorAllocate (Simage, 0,50, 255) ; 
Sdarkblue = ImageColorAllocate($image,0,0, 192) ; 
Scols = array($lightblue, Sblue, Sdarkblue) ; 
Swhite = ImageColorAllocate($image, 255, 255,255) ; 
ImageFill( Simage, 0,0, Swhite) ; 
srand((double)microtime() * 1000000); 

for ($dots=1 ;$dots<100;$dots++){ 
Sposx = rand(0,300) ; 
Sposy = rand(0,300) ; 
Ssize = rand(10,30); 
Scoi = rand(0,2) ; 



/ 



In>ageArc($image 1 $posx,Sposy,Ssize ) $size,0,360,$col 8 |$ool]); 



ImagePNG($image , 1 graphics/bubbles . png ' ) ; 
ImageDestroy($image) ; 

?> 

<img src='graphics/bubbles.png'> 



Questo script produce un'immagine costituita da molti cerchi disposti in modo ca- 
suale che, per esempio, potrebbe essere utilizzata (con qualche ritocco) come sfon- 
do di uria pagina Web. Per il momento, tuttavia, si è scelto di generare semplice- 
mente 1 immagine e visualizzarla sul Web. L'output di questo script è quello della 
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Figura 30. 19 

Cerchi casuali. 



Osservate il funzionamento del programma. Le prime righe del codice dovrebbero 
ormai esservi familiari, in quanto si limitano a creare un'immagine di 300 x 300 
pixel, definiscono alcuni colori che verranno applicati e riempiono l'immagine con 



$image = ImageCreate(300,300) ; 

Slightblue = ImageColorAllocate($iraage,64,64,255) : 
$blue = ImageColorAllocate($image, 0,50, 255); 
Sdarkblue = ImageColorAllocate($image,0,0, 192) • 
$cols = array($lightblue,$blue, $darkblue) ; 



$white = ImageColorAllocut#(llmiQO,265,2S6,255); 
ImageFill($image,0,0,$wh.ito) ; 



La riga successiva viene utilizzala per inizializzare il generatore di numeri casuali: 
srand( (double)microtime( ) * 1000000); 

Le righe ulteriori utilizzano un ciclo f or per generare 100 cerchi, ciascuno dei quali 
ha le proprie coordinate X e Y casuali sull'immagine, oltre a una dimensione e un 




produrre: 

for (Sdots=1 ;$dots<100;$dots++){ 
$posx = rand (0,300) ; 
$posy = rand(0,300) ; 
$size = rand(10,30); 
$col\= rand (0,2) ; 

Image^•r-c^$image^$posx,$posy,$size,$size,0,360,$cols[$coll ) ; 

Infine l'immagine viene memorizzata e tutta la memoria utilizzata per la sua creazio- 
ne viene rilasciata: 

ImagePNG($image, 1 graphics/bubbles. png 1 ) ; 
ImageDestroy($image) ; 



Motivi ri 



Questo paragrafo mostra che cosa è possibile produrre con un semplice programma, 
un numero casuale e un insieme di regole di base. Lo script seguente non introduce 
funzioni o coi — " : : : - ■<■-.-; — - ; ; • .• .. i...-- . 



<?php 



incetti nuovi: è una semplice dimostrazione di ciò che è possibile produrre. 



// Immagini GD - Esempio 30-17 

.// 



Simage = ImageCreate(251 ,251 ) ; 
$blue = ImageColorAllocate($image, O,50, 255) ; 
$white = lmageColorAllocate($image,255,255,255) ; 
ImageFill($image,0,0,$white) ; 
srand((double)microtime() * 1000000); 

$x = array(125, 250,0) ; 
$y = array(0,250,250) ; 

ImageLine($image,$x[0| ,$y I0] ,$x[ 1 ] ,$y [ 1 ] ,$blue) ; 
IniageLine($iniag.o,$x[ 1 j ,$y| 1 ) ,$x|2) ,$y[2] ,$blue) ; 
ImageLine($imaao,$x|2| ,ty|2| , *x l 0 ) ,$y[0) ,$blue) ; 




$lx=0; 
$ly=0; 
Semini 0; 



while (Scount < 10080) ( 
$count++; 

$rand = rand(0,2) ; 

$nx = ($x[$rand) - Slx) / 2; 

Sny = ($y[$rand] - $ly) / 2; 

ImageLine($image J $lx+Snx,$ly+$ny,$lx+$nx,$ly+$ny J $blue); 
Slx = $lx+$nx; 
Sly = $ly+$ny; 

:> , • . va.., p.-j, ■ ■ 

ImagePNG( Simage, 1 graphics/triangolo. png 1 ) ; 
ImageDestroy(Simage); 



<img src= ' graphics/triangolo . png 1 > 

L'output prodotto da questo programma è quello della Figura 30.20. 




Figura 30.20 

Motivi ripetuti. 



Se volete scoprite come si forma l'immagine della Figura 30.20, dovete esaminali' 
questo script in modo più dettagliato. Le prime righe di codice definiscono un'im- 
magine di 251 x 251 pixel e creano alcuni colori. 

L'immagine viene riempita di bianco e il generatore di numeri casuali viene inizia- 
lizzato: 

Simage = ImageCreate(251 ,251 ) ; 

$blue = ImageColorAllocate (Simage, 0,50, 255) ; 

Swhite = ImagQColorAllocate($image,255,255,255); 



ImageFìll($image ,0,0,$whl.to) ; 
•rand((double)microtime() • 100e«e«); 



Poi vengono creati due array di km «•«liliale N e Y e il loro contenuto viene utilizzato 
«la tre funzioni ImageLine( ) pei la «reazione del triangolo di contorno dell'imma- 
iine: 

$x = array(125,250,0) ; 
$y = array(0,250,250) ; 

lmageLinefSimage.Sxta] ,$y[0] ,$x[1] ,$y[1] ,$blue) ; 
ImageLine($image,$x[1 ] ,$y[1 ] ,$x[2] ,$y[2] ,$blue) ; 
ImageLine($image,$x[2] ,$y[2] ,$x[0] ,$y[0] ,$blue) ; 

Quindi viene impiegato un ciclo while per generare una riga (della lunghezza ef- 
fettiva di un solo pixel) sull'immagine. Questo induce la creazione del motivo geo- 
metrico: 

Hpk ... 

$lx=0;\. 

$ly=0; 

$count=0; 

while (Scount < 10000) { 
$count++; 

Srand = rand(0,2); 

Snx = ($x[$rand] - $lx) / 2; 

Sny = ($y[$rand) - $ly) / 2; 

ImageLine ( Simage , $lx+$nx , $ly+$ny , $lx+$nx , $ly+$ny , Sblue ) ; 
Slx = $lx+$nx; 
Sly = $ly+$ny; 



Infine, l'immagine viene archiviata e la memoria rilasciata: 

ImagePNG( Simage, 'graphics/triangolo. png' ) ; 
ImageDestroy (Simage) ; 

mi / 
Riepilogo 

Questo capitolo ha introdotto la libreria GD e ha mostrato come le immagini possa- 
no essere create da zero e come sia possibile modificare immagini già esistenti. Una 
volta comprese le basi della libreria di funzioni, dovreste riuscire a produrre anche 
Immagini molto complesse. Nel capitolo sono stati offerti alcuni esempi degli effetti 
die è possibile produrre con la libreria, mentre nel prossimo si vedrà come sfruttare 
le tecniche e le funzioni illustrare in queste pagine per creare immagini grafiche di- 
namiche particolarmente utili, 



Capitolo 3 1 

Creazione di un'immagine 
dinamica 



Introduzione 



Nel capitolo precedente è stata introdotta la libreria GD e sono state presentate al- 
cune tra le numerose funzioni disponibili per la creazione e la manipolazione di im- 
magini. È stato anche proposto qualche esempio di utilizzo della libreria, mettendo 
ni luce in particolare come sfruttare le funzioni per lo sviluppo di pagine Web dina- 
miche. 

< hiesto capitolo presenta un'applicazione completa che utilizza molte funzioni di li- 
Li . V . i .11. 

Drena analizzate nel capitolo precedente. 

SI inizierà presentando l'applicazione e fornendo qualche esempio delle sue poten- 
zialità; sarete quindi guidati nell'analisi dello script e scoprirete come è stata svilup- 
pala l'applicazione. 

Presentazione dell'immagine 

'Lo script può creare semplici istogrammi: nella Figura 31-1 potete vedere un esem- 
pio di quello che si può ottenere con esso. L'immagine è costruita con la chiamata a 
una funzione graph(); si tratta di una funzione configurabile e questo consente 
all'utente di stabilire la dimensione reale dell'istogramma, i colori utilizzati, il testo 
dei titoli e delle etichette, nonché i valori dei dati visualizzati. Tutto ciò significa che 
la grande versatilità di questa funzione consente di utilizzarla per visualizzare in 
modo dinamico una vasta gamma di tipi di dati nei siti Web. 

Magari volete rappresentare graficamente il numero dei nuovi utenti che accedono 
mese per mese al sito, oppure le risposte degli utenti del sito Web a una serie di do- 
mande tratte da un questionario. 

Anche se i dati visualizzati in questo grafico sono statici, nei prossimi capitoli impa- 
rerete a interfacciare PHP con i database. In tal modo potrete ottenere i dati me- 
diante un modulo Web, memorizzarli in un database e poi recuperare e visualizzare 
Duesti dati con la funzione grapfi( ). 

Per ora limitiatevi ad analizzare la schermata di esempio della Figura 31. 1- Essa 
Riostra un grafico che visualizza 12 valori mensili, La dimensione del grafico è di 
300 X 200 pixel. La scala del grafico è calcolata automaticamente e ha un intervallo 
0-100. 
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Operazione completata 



Figura 31.1 

Istogramma con valori mensili, esempio I . 



La Figura 31.2 mostra un altro grafico realizzato con la stessa funzione graph ( ) . in 
questo secondo esempio sono riportati cinque valori che rappresentano il livello di 
qualità di un servizio. La dimensione del grafico è 250 X 200 pixel e, ancora una vol- 
ta, la scala del grafico viene creata automaticamente: 0-1456. 
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Figura 3 1.2 

Istogramma, esempio 2. 
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Infine, la Figura 31.3 presenta un ulteriore esempio di grafico a barre, costituito da 
due valori dati. Questi valori rappresentano le risposte a domande del tipo "sì/no". 
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Figura 31.3 

Istogramma, esempio 3. 



Tutti e tre gli esempi dimostrano che lo sviluppatore controlla la dimensione 
dell'immagine del grafico, i colori impiegati, le etichette visualizzate e i valori dei 
dati utilizzati per creare le barre. 

Il capitolo prosegue analizzando la creazione di un grafico con la funzione 
graph ( ) . Il progetto finale è stato suddiviso in parti più piccole e più comprensibili 
che verranno esaminate una alla volta, fino ad ottenere la creazione dell'applicazio- 
ne completa. 

Creazione di uno sfondo colorato 
ridimensionabile 



Lo sviluppo del grafico ha inizio progettando le parti della funzione che permettono di 
creare l'immagine e colorarla. La funzione graph ( ) inizialmente appare come segue: 



<?php 

function graph($name,$w,$h,$bgc) { 
$image = ImageCreate($w,$h) ; 
$cols = colours($image) ; 
ImageFill($image,0,0,$cols[$bgc] ) ; 
ImageJPEG($image, $name); 
ImageDestroy ($image) ; 

} 



La funzione è stata scritta in modo da ricevere quattro parametri: il nome dell'imi».! 
gine da creare, la larghezza e l'altezza dell'immagine, il colore dello sfondo: 

function graph($name,$w,$h,$bgc) { 

Successivamente, viene invocata la funzione ImageCreate( ) per costruire l'imi n i 
gine con i valori larghezza e altezza memorizzati rispettivamente in $w e $h: 

Simage = ImageCreate($w,$h) ; 

Poi viene invocata una funzione di nome colours(). Tale funzione restituisce un 
array di colori da utilizzare con l'immagine. I colori definiti sono memorizzati 
nell'array $cols: 

Scols = colours($image) ; 

Lo sfondo dell'immagine viene creato con la funzione ImageFill( ). L'array coli 
viene indicizzato con la variabile $bgc, che memorizza il colore di sfondo dell'Ini 
ma gine: 

ImageFill ($image ,0,0, Scols [Sbgc] ) ; 

Infine la funzione graph( ) viene completata con la creazione dell'immagine utili/ 
zando il valore memorizzato in $name, quindi la memoria viene rilasciata: 

ImageJPEG($image, $name); 
ImageDestroy($image) ; 

La funzione colours( ) viene utilizzata per creare un array contenente le definizio 
ni dei colori da applicare all'immagine. Specificando un valore compreso tra 0 e 14, 
Putente può fare riferimento a un particolare colore memorizzato nell'array: 

function colours($image) { 

Swhite = ImageColorAllocate($image,255,255,255) ; 

$black = ImageColorAllocate($image, 0,0,0); 

$lightblue = ImageColorAllocate(Simage,64,64,255) ; 

$blue = ImageColorAllocate($image,0,0,255) ; 

Sdarkblue = ImageColorAllocate($image,0,0,l92) ; 

$red = ImageColorAllocate($image,255,0,0) ; 

Slightred = ImageColorAllocate($image, 255, 64,64) ; 

Sdarkred = ImageColorAllocate($image, 192,0,0) ; 

$green = ImageColorAllocate($image, 0,255,0) ; 

Slightgreen = ImageColorAllocate($image,64,255,64) ; 

$darkgreen = ImageColorAllocate($image, 0,192,0) ; 

Syellow = ImageColorAllocate($image, 255, 255,0) ; 

$grey = ImageColorAllocate($image, 192, 192, 192) ; 

$darkgrey = ImageColorAllocate (Simage, 128, 128, 128) ; 

$lightgrey = ImageColorAllocate (Simage, 192, 192, 255) ; 

$cols = array($white,$black,$lightblue,$blue, Sdarkblue, Sred, 

Slightred, Sdarkred.Sg reen, Slightgreen, Sdarkgreen, 
return $cols; > 9 y. 9 y,$ ightgrey), 

} 



La funzione graph ( ) viene invocata con una semplice chiamata. I valori passati alla 
funzione sono: "graph . j peg" (il nome dell'immagine) 200 (la larghezza) 150 (l'al- 
tezza) e 1 4 (il colore di sfondo che corrisponde a grigio chiaro): 

Qraphf'graphics/graph. jpeg" , 200, 150, 14); 

|> ' ' 

<img src=' graphi.es/graph.jpeg 1 > 

La parte dello script completata finora è la seguente: 
<?php 

n~ 

// Grafico GD - Esempio 31-1 

I 

function graph($name,$w,$h,$bgc) { 
Simage = ImageCreate($w,$h) ; 
Scols = colours($image) ; 
ImageFill (Simage ,0,0, $cols [ $bgc ] ) ; 
ImageJPEG($image, $name); 
ImageDestroy($image) ; 

function colours($image) { 

$white = ImageColorAllocate($image,255,255,255) ; 
$black = ImageColorAllocate($image,0,0,0) ; 
Slightblue = ImageColorAllocate($image, 64,64, 255) ; 
Sblue = ImageColorAllocate($image,0,0,255) : 
$darkblue = ImageColorAllocate($image,0,0,192) ; 
$red = ImageColorAllocate($image,255,0,0) ; 
$lightred = ImageColorAllocate($image,255,64,64) ; 
Sdarkred = ImageColorAllocate($image, 192,0,0) ; 
Sgreen = ImageColorAllocate(Simage,0, 255,0) ; 
Slightgreen = ImageColorAllocate($image,64,255,64) ; 



Sdarkgreen = ImageColorAllocate($image,0, 192,0) ; 
Syellow = ImageColorAllocate($image, 255, 255,0) ; 
Sgrey = ImageColorAllocate (Simage, 192, 192,192) ; 
Sdarkgrey = ImageColorAllocate (Simage, 128,128, 128) ; 
Slightgrey = ImageColorAllocate (Simage, 192, 192, 255); 
Scols = array($white,$black, Slightblue, Sblue, Sdarkblue, Sred, 

Slightred , Sdarkred , $g reen , Slightgreen , Sdar kg reen , 
Syellow, Sgrey, Sdarkgrey, Slightgrey); 

return Scols; 

1 

oraph( "graphics/graph. jpeg" , 200, 150, 14); 
<img src=' graphics/graph. j peg ■> 



jos Capitolo J l 



L'output ottenuto da questo programma è quello della Figuro 51.4; 
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Figura 3 1.4 

Grafico parte I , immagine dimensionabile. 



■ 

Creazione dell'asse del grafico 
e delle righe orizzontali 

La parte successiva dello script si occupa della creazione di un bordo che contrasse- 
gni gli assi dell'istogramma e di qualche riga orizzontale. Le prime modifiche appor- 
tate allo script riguardano la funzione graph( ), il cui numero di parametri è stato 
aumentato per consentire all'utente di specificare il colore di primo piano: 

■ 

function graph($name,$w,$h,$bgc,$fgc) { 

All'inizio della funzione graph() vengono aggiunte quattro variabili per definire i 
bordi superiore, inferiore, destro e sinistro del grafico: 

$top=15; 
$right=5; 
$left=35; 
$bottom=25; 

Quindi, dopo la chiamata alla funzione ImageFill() all'interno della funzione 
graph( ) , vengono inserite due nuove chiamate a funzione: 

drawAxis($image,$w,$h,$cols[$fgc] ,$top,$right,$left, Sbottoni) ; 
drawLines($image,$w,$h,$cols[$fgc] , Stop, $right,$ieft, Sbottoni) ; 

Queste due funzioni creano l'asse del grafico e le linee tratteggiate orizzontali. A en- 
trambe le funzioni vengono passate le variabili contenenti handle dell'immagine, 
larghezza, altezza, colore di primo piano e bordo. Queste sono tutte le modifiche 
che occorri .<|»| are alla funzione graph( ) SI devono però ancora i ostruire dui 
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l'unzioni: drawAxis( ) e drawDashedLines( ). La prima è la più semplice e utilizza 
i propri parametri per disegnare l'asse del grafico come un rettangolo: 

function drawAxis (Simage, $w, $h, Scoi, Stop, $right,$left, Sbottoni) { 
ImageRectangle (Simage, Sleft, Stop, $w-$right, $h -Sbottoni, Scoi) ; 

La funzione drawDashedLines( ) è un po' più complessa. Per prima cosa calcola 
l'altezza del grafico, tenendo conto dei bordi superiore e inferiore. Quindi calcola la 
spaziatura tra le righe tratteggiate, il cui valore è memorizzato nella variabile $spa- 
ce. Infine utilizza un ciclo f or per visualizzare le quattro righe nel grafico: 

function drawLines($image, $w, $h, Scoi, Stop, $right,$left, Sbottoni) { 
SgHeight = $h - (Stop + Sbottoni) ; 
Sspace = SgHeight / 4; 
$y = Stop; 

for($a=1 ;$a<5;$a++) { 

ImageLine (Simage , $lef t , $y , Sw-$right , $y , Scoi) ; 
$y=$y+$space; 

1' * 

L'invocazione della funzione graph{ ) deve contenere un parametro aggiuntivo che 
specifica il colore di primo piano, che in questo esempio è azzurro chiaro: 

graph("graphics/graph.jpeg", 200, 150, 14, 2); 

Lo script sviluppato sinora è il seguente: 

<?php 

// Grafico 6D - Esempio 31-2 

function graph($name,$w,$h,$bgc,$fgc) { 
$top=15; 
$right=5; 
$left=35; 
$bottom=25; 

Simage = ImageCreate($w,$h) ; 
Scols = colours(Simage) ; 
ImageFill( Simage, 0,0,$cols[$bgc] ) ; 

drawAxis (Simage, $w,$h, Scols [Sfgc] , Stop, $right,$left, Sbottoni) ; 
drawLines ( Simage , $w, $h , Scols [ $f gc] , Stop, Sright , Slef t .Sbottoni) ; 
ImageJPEG($image, $name); 
ImageDestroy (Simage) ; 

function colours (Simage) { 

Swhite = ImageColorAllocate($image,255,255,255) ; 
Sblack = ImageColorAllocate($image, 0,0,0) ; 
Slightblue = ImageColorAllocate($image,64,64,255) ; 
Sblue = ImageColorAllocato($inuigo,0,0,255) ; 
Sdarkblue = ImageColorAllocott (Simage, 0,0, 192) ; 

$rod ImagoColorAI >■>• «.») ; 

Slightred - Imagacoioi ai i<>. «witimago, 288, 64,64) ; 



Sdarkred = ImageColorAllocate($image, 192,0,0) ; 

$green = ImageColorAllocate($image, 0,255,0) ; 

$lightgreen = ImageColorAllocate($image, 64,255,64) ; 

Sdarkgreen = ImageColorAllocate( Simage, 0, 192,0) ; 

Syellow = ImageColorAllocate($image, 255, 255,0) ; 

$grey = ImageColorAllocate(Simage, 192, 192, 192) ; 

Sdarkgrey = imageColorAllocate ($image, 128, 128,1 28 ) ; 

$lightgrey = ImageColorAllocate($image, 192, 192,255) ; 

$cols = àrray($white,$black,$lightblue,$blue,$darkblue,$red, 

Slight red , $darkred , $green , Slightgreen , $darkgreen , 
Syellow, Sgrey, Sdarkgrey, Slightgrey) ; 

return $cols; 

function drawAxis (Simage, $w, $h, $col, Stop, Sright, Sleft, Sbottoni) { 
ImageRectangle($image, Sleft, Stop, $w-$right,$h -Sbottoni, Scoi) ; 

} 



function drawLines($image, $w, Sh, Scoi, Stop, Sright, Sleft, Sbottoni) { 
SgHeight = $h - (Stop + Sbottoni); 
Sspace = SgHeight / 4; 
$y = Stop; 

for($a=1 ;$a<5;$a++) { 

ImageLine ( Simage , Sleft , $y , $w - Sright , $y , $col ) ; 
$y=$y+$space; 

} 

} 



graph("graphics/graph.jpeg", 200, 150, 14, 2); 



;?> 

<img src='graphics/graph. jpeg'> 

L'output ottenuto dalla funzione graph( ) è quello della Figura 31.5. 

Creazione del titolo 

e delle etichette per gli assi 

La fase successiva riguarda Pinserimento del titolo e delle etichette per gli assi X e 
Y. La funzione graph( ) viene modificata in modo da includere altri tre parametri: il 
titolo e lè due etichette. 

function graph($name,$w,$h,$bgc,$fgc,$title,$xtitle,Sytitle) { 

Successivamente, viene inclusa una chiamata a funzione dopo l'invocazione di 
drawLines ( ) , che visualizza queste etichette: 

drawTitlesf Simage, $w,$h,$cols[$fgc] ,$title,$xtitle,$ytitle) ; 



A questo punto è necessario includere anche la funzione tlrawTitles( ), che calco- 
la la lunghezza «lei titolo e delle due etichette e le vImiuIIzzu .il .nino, in posizioni 
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Figura 3 1 .5 

Grafico parte 2, bordi e righelli orizzontali 



fisse dell'immagine. Non viene eseguito alcun test per verificare se il testo si adatta 
alla posizione. Si presuppone che lo sviluppatore si accerti prima che il grafico sia 
sufficientemente grande per visualizzare i titoli e le etichette: 

function drawTitles($image,$w,$h,$col,$title,$xtitle,$ytitle) { 
Swidth = ImageFontWidth(1 ) * strlen(Stitle) ; 
Sx = ($w - Swidth) 12; 
ImageString (Simage, 1 ,$x,3,$title,$col) ; 
Swidth = ImageFontWidth(1 ) * strlen(Sytitle) ; 
$x = (Sw - Swidth )/2; 

ImageString($image,1 ,$x,$h-10,$ytitle,$col) ; 
Sheight = ImageFontWidth(1 ) * strlen(Sxtitle) ; 
$y = ($h - $height)/2; 

ImageSt ringUpf Simage, 1 ,1 ,$y+$height,$xtitle,$col) ; 

> 

Infine viene modificata la chiamata alla funzione graph ( ) per includere gli altri tre 
parametri: 

graph( "graphics/graph. jpeg" , 200, 150, 14,2, "Totale delle vendite" , 
"Vendite (euro) ", "Giorni feriali"); 



L'output ottenuto dalla funzione graph ( ) è quello della Figura 31.6. 



Creazione delle etichette dei dati per Tasse X 

Per creare le etichette dell'asse X dovete aggiungere due parametri nuovi alla fun- 
zione graph ( ) , ossia il numero delle etichette dei dati (e di dati che arriveranno) e 
un array contenente le etichette: 



function graph ( Sname, $w, $h, Sbgc ,$fgc, Stit le, $xtitle,$ytitle,$numX, 
SxTitles) { 
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Figura 31.6 

Grafico parte 3, titolo ed etichette. 

Dopo l'invocazione della funzione drawTitles( ) viene inserita una chiamata a 
funzione che visualizza le seguenti etichette: 

drawXLables ($iiTiage,$w,$h,$right,$left,$cols[$fgc] , SnumX, SxTitles) ; 

Occorre anche includere la funzione drawXLables( ), che calcola la spaziatura tra 
ciascuna etichetta e poi, con un ciclo f or, le visualizza nel grafico: 

f unction drawXLables ($image , $w , $h , $right , $lef t , $col , $numX , $xTitles) { 
$graphWidth = $w - ($right+$left) ; 
$spacing = SgraphWidth/SnumX; 
$x = $left + ($spacing/4) ; 
f or($a=0;$a<$numX;$a++) { 

ImageString($image,1 ,$x,$h-20,$xTitles[$a] ,$col) ; 

$x=$x+$spacing; 

} 

} 



Ancora una volta è compito dello sviluppatore verificare che ci sia spazio sufficiente 
per ospitare le etichette nel grafico. Infine, prima di invocare la funzione graph ( ) , 
è necessario definire un array che contenga le etichette dell'asse X. La chiamata alla 
funzione graph ( ) dev'essere modificata per contenere il numero di etichette e l'ar- 
ray: 

SxTitles = array ( "Lun" , "Mar" , "Mer" , "Gio" , "ven" ) ; 
graph( "graphics/graph. jpeg" , 20C, 150, 14,2, "Totale delle 
vendite" , "Vendite (euro) ", "Giorni feriali" ,5,$xTitles) ; 

L'output ottenuto dalla funzione graph ( ) è quello della Figura 31.7. 
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Creazione della scala numerica per l'asse Y 

Per visualizzare la scala numerica dell'asse Y, dovete sapere quali valori compai 
ranno nella scala. Pertanto dovete modificare la funzione graph() in modo che 
valori possano essere passati come un array e memorizzati nella variabile $xVa 
lues: 

f unction graph ($name , $w, $h , $bgc , $f gc , $title , $xtitle , Sytitle , SnumX, 
SxTitles ,$xValues) { 

Successivamente, si ricorre a una chiamata alla funzione calcMaxDataItem( ) p< 
Stabilire quale sia il valore più grande, in modo da calcolare la scala per l'asse "! 
Questa chiamata viene inserita dopo quella alla funzione drawXLables ( ) : 

$max = calcMaxDataItem($xValues, SnumX) ; 

Con una chiamata alla funzione drawYLables( ) potrete visualizzare i valori numi 
rlci: 

drawYLables($image,$w,$h,$cols[$fgc] ,$top,$right,$left, Sbottoni, $max) ; 

Li funzione calcMaxDataltemf ) utilizza un semplice ciclo f or per esaminare ci: 
scuri dato e stabilire quale sia il più grande: 

function calcMaxDataItem($xValues, SnumX) { 
$temp=0; 

for($a=0;$a<$numX;$ii' • ) { 
if ($xvalues[$a| > |i< 
Stemp - $xValuoi|fn| , 



> 



return $temp; 



Una volta stabilito qual è il valore più grande della scala dell'asse Y, la funzione 
drawYLables () è in grado di calcolare i valori di quattro numeri da visualizzare 
sull'asse Y sottraendo un quarto del numero massimo per quattro volte. La funzione 
determina il numero di caratteri contenuti in ogni numero della scala dell'asse Y per 
posizionarlo correttamente lungo l'asse Y: 

f unction drawYLables ($image , $w , $h , $col , Stop , $right , $lef t , Sbottoni , Smax ) { 
SgHeight = $h - (Stop + Sbottoni) ; 
Sspace = SgHeight / 4; 
$y = Stop; 

Squater = round($max/4,0) ; 
for($a=1 ;$a<5;$a++) { 

$len = strlen(Smax) ; 

Swidth = ImageFontWidth(1 ) * $len>-- 

ImageSt ring ( Simage , 0 , 32 - Swidth / 4ty - 2 , Smax , Scoi ) ; 

$y=$y+$space; / 

$max=$max -Squater; 

} 

} 



■ 



Infine viene creato un array per memorizzare i valori e modificare la chiamata alla 
funzione graph ( ) per passarle il seguente array: 

SxTitles = array("Lun","Mar","Mer","Gio" ) "Ven"); 
SxValues = array(50,55,78,87,32) ; 

graph("graphics/graph.jpeg", 200, 150, 14,2, "Totale delle vendite", 
"Vendite (euro) ", "Giorni feriali" ,5, SxTitles, SxValues, 5) ; 

L'output ottenuto dalla funzione graph ( ) è quello della Figura 31.8. 
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Figura 3 1 .8 

Grafico parte 5, numeri dell'asse Y. 
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Visualizzazione dei dati 

L'ultima operazione consiste nella visualizzazione dei dati nel grafico. Si comincia 
inserendo un ultimo parametro nella funzione graph ( ) che conterrà il valore di co- 
lore delle barre del grafico: 

f unction 

graph (Sname , $w, $h ,$bgc ,$f gc , Stitle , Sxtitle , Sytitle , SnumX , SxTitles , 
SxValues, Sbc) { 

Quindi, dopo la funzione drawYLabels( ) si inserisce una chiamata alla funzione 
drawData( ) per elaborare i dati del grafico: 

drawData( Simage, $w,$h, $cols[ $bc] ,$top,$right,$left, Sbottoni, SnumX, SxValues, 
Smax) ; 

A questo punto si utilizza la funzione drawData( ), che calcola la dimensione di ogni 
barra del grafico basandosi sulla dimensione complessiva dell'immagine e sul valore 
dei dati. Ogni barra viene visualizzata con la funzione ImageFilledRectangle( ): 

f unction 

drawData (Simage, $w,$h, Scoi, Stop, $right,$left, Sbottoni, SnumX, SxValues, Smax) 
{ 

SgraphHeight = $h - ($top+$bottom) ; 
SpixelValue = SgraphHeight / Smax; 
Sgraphwidth = $w - ($right+$lef t) ; 
Sspacing = SgraphWidth/SnumX; 
Sgap = $spacing/4; 
$x = Sleft + ($spacing/6) ; 
for($a=0;$a<$numX;$a++) { 

SrectSize = (SgraphHeight + Stop) - SxValues [ Sa] *SpixelValue; 

ImageFilledRectangle (Simage, $x,$rectSize,$x+($spacing -Sgap) , 



$x=$x+$spacing; 



$h-$bottom,$col) ; 



} 



li 



) 

HE 

Infine, si modificha l'invocazione della funzione graph ( ) per includere un parame- 
tro che rappresenta il colore delle barre, in questo esempio rosso: 

SxTitles = array ( "Lun" , "Mar" , "Mer" , "Gio" , "Ven" ) ; 
SxValues = array (50,55,78,87,32) ; 

graph("graphics/graph. jpeg" , 200, 150, 14,2, "Totale delle vendite", 
"Vendite (euro) ", "Giorni feriali" ,5, SxTitles, SxValues, 5) ; 



euro)" , "Giorni feriali" ,5, SxTitles, SxValues, 5) ; 
script conclusivo è il seguente: 



<?php 

// Grafico GD - Esempio 31 -6 

m 



function 

graph($namo, Sw.Sh.Sbgc.Sf oc nU,»»t ltlp.lytitle.SnumX, SxTitles .SxValues 



$top=15; 
$right=5; 
$left=35; 
$bottom=25; 

$image = ImageCreate($w,$h) ; 
$cols = colours ( Simage ) ; 
ImageFill (Simage ,0,0, Scols [ Sbgc ] ) ; 

drawAxis (Simage, $w, $h , $cols [$f gc ] , $top , Sright , $lef t , Sbottoni) ; 
drawLines( Simage, $w,$h, Scols [Sfgc] , Stop, Sright, Sleft .Sbottoni) ; 
drawTitles($iniage,$w,$h,$cols[$fgc] ,$title,$xtitle,$ytitle) ; 
drawXLables (Simage, $w,$h, Sright, Sleft, Scols [$f gc] , SnumX, SxTitles) ; 
Smax = calcMaxDataItem($xValues, SnumX) ; 

drawYLables($image J $w,$h,$cols[$fgc] , Stop, Sright, Sleft, Sbottoni, Smax) ; 
drawData (Simage ,$w, $h, Scols [$bc] , $top , Sright , Sleft .Sbottoni , SnumX, 

,oc.?» values '! max) ; 

ImageJPEG($image, $name); 
ImageDestroy ( Simage ) ; 



function colours($image) { 

Swhite = ImageColorAllocate($image,255,255,255) ; 
$black = ImageColorAllocate($image, 0,0,0) ; 
$lightblue = ImageColorAllocate($image,64,64,255) ; 
$blue = ImageColorAllocate($image,0,0,255) ; 
Sdarkblue = ImageColorAllocate($image,0,0,192) ; 
$red = ImageColorAllocate($image,255,0,0) ; 
$lightred = ImageColorAllocate($image,255,64,64) ; 
$darkred = ImageColorAllocate($image, 192,0,0) : 



jreen = ImageColorAllocate($image, 0,255,0) ; 



Slightgreen = ImageColorAllocate($image,64,255,64) ; 

Sdarkgreen = ImageColorAllocate($image, 0,192,0) ; 

Syellow = ImageColorAHocate (Simage, 255, 255,0) ; 

Sgrey = ImageColorAllocate (Simage, 192, 192,1 92 ) ; 

Sdarkgrey = ImageColorAllocate (Simage, 128, 128,1 28 ) ; 

Slightgrey = ImageColorAllocate (Simage, 192, 192,255) ; 

Scols = array (Swhite, $black,$lightblue,$blue, Sdarkblue, Sred, 

Slightred , Sdarkred , Sgreen , Slightgreen , Sdarkgreen , 
Syellow, Sgrey , Sdarkgrey , Slightgrey) ; 

return Scols; 



} 



function drawAxis($image, $w, $h, Scoi, Stop, $right,$left, Sbottoni) { 
ImageRectangle (Simage, Sleft, Stop, $w-$right,$h -Sbottoni, Scoi) ; 

} 

function drawLines (Simage, $w, $h, Scoi, Stop, Sright, Sleft, Sbottoni) { 
SgHeight = $h - (Stop + Sbottoni); 
Sspace = SgHeight / 4; 
$y = Stop; 

f or($a=1 ;$a<5;$a++) { 

ImageLine (Simage, $left,$y,$w- Sright, $y, Scoi) ; 



} 



$y=Sy+$space; 



function drawTitlesfSimage.Sw.Sh.Scol.Stitle.Sxtitle.Sytitle) { 
Swidth - ImogeFontWidth(l) • 8 trlen($tltlo) ; 



l 



$x = ($w - Swidth )/2; 
ImageString (Simage, 1 ,$x,3,$title,$col) ; 
Swidth = ImageFontWidthjl ) * strlen(Sytitle) ; 
$x = ($w - Swidth) 12; 

ImageString (Simage, 1 ,$x,$h-10,$ytitle,$col) ; 
Sheight = ImageFontWidth(1 ) * strlen(Sxtitle) ; 
$y = ($h - Sheight) /2; 



ImageStringUp($image,1 ,1 ,$y+$hei 




nction drawXLables (Simage, $w,$h, Sright, Sleft, Scoi, SnuniX,$xTitles) { 
SgraphWidth = $w - ($right+$left) ; 
Sspacing = SgraphWidth/SnumX ; 
$x = Sleft + ($spacing/4) ; 
for($a=0;$a<$numX;$a++) { 

ImageString ( Simage, 1 ,$x,$h-20,$xTitles[$a] ,$col) ; 
Sx=$x+$spacing; 

B; ' ■ ■ ■ ■ 

K 

■ • • 

function calcMaxDataItem($xValues, 
$temp=0; 

for($a=0;$a<$numX;$a++) { 
if ($xValues[$a) > Stemp) 
Stemp = $xValues[$a] ; 

■ } 

return Stemp; 

} 

function drawYLables (Simage , $w, $h , Scoi , Stop, Sright , Sleft , Sbottoni , Smax ) { 
SgHeight = $h - (Stop + Sbottoni); 
Sspace = SgHeight / 4; 
$y = Stop; 
Squater = round ($max/4, 0) ; 
for($a=1 ;$a<5;$a++) { 

Slen = strlen(Smax) ; 

Swidth = ImageFontWidth(l) * Slen; 

ImageString (Simage , 0, 32 -Swidth , $y -2 , Smax , Scoi) ; 

$y=$y+$space; 

$max=$max- Squater; 

function drawData (Simage , $w,$h , Scoi , Stop , Sright , Sleft , Sbottoni, SnumX , 
SxValues,$max) { 

SgraphHeight = $h - ($top+$bottom) ; 
SpixelValue = SgraphHeight / Smax; 
SgraphWidth = $w - (Sright+Sleft) ; 
Sspacing = SgraphWidth/SnumX; 
Sgap = $spacing/4; 
$x = Sleft + ($spacing/6); 
for($a=0;$a<$numX;$a++) { 

SrectSize = (SgraphHeight + Stop) - $xValues[$a] 'SpixelValue; 
ImageFilledRectanole (Simage, Sx,$rectSize,$x+ (Sspacing -Sgap) , 
$tv Sbottoni, Scoi) ; 

$x=$x+$spacing; 



} 

} 

SxTitles = array ( "Lun" , "Mar" , "Mer" , "Gio" , "Ven" ) ; 
SxValues = array(50,55,78,87,32) ; 

graph("graphics/graph.jpeg", 200, 150, 14,2, "Totale delle vendite" , 
"Vendite (euro) ", "Giorni feriali" ,5, SxTitles, SxValues, 5) ; 

?> 

<img src='graphics/graph.jpeg'> 

L'output ottenuto dalla funzione graph ( ) è quello della Figura 31.9. 




Figura 31.9 

Grafico parte 6, grafico ultimato. 



Ecco fatto. Sono stati effettuati sei passaggi per completare un'immagine utile che 
può essere utilizzata per molte pagine Web. 

Riepilogo 

Questo capitolo ha illustrato come utilizzare la libreria GD per creare un'immagine 
utile e sufficientemente flessibile per essere utilizzata in una vasta gamma di situa 
zioni. Il prossimo capitolo introduce la libreria di funzioni PDFLib e spiega come 
utilizzare queste funzioni per creare documenti PDF personalizzati. 




Capitolo 32 

Creazione 

di documenti PDF 

■ 

Introduzione 

PDFIib è una libreria di Minzioni creata per consentire la generazione di documenti 
nel formato PDF (Portable Document Format) di Adobe. Il formato PDF è diventato 
uno standard per l'archiviazione di documenti sul Web. 

La libreria PDFIib ora è disponibile per PHP e le versioni più recenti di PHP la inclu- 
dono già nel pacchetto. Quindi dovete soltanto attivarla per poter iniziare a dar vita 
a documenti PDF dinamici. 

Questo capitolo offre un'introduzione alla libreria PDFLib e analizza alcune funzio- 
ni a disposizione degli sviluppatori. 

Attivazione della libreria PDFIib 

La libreria di funzioni PDFIib viene fornita con l'installazione di PHP, tuttavia è ne- 
cessario modificare il file php.ini per attivarla. Questo file si trova nella directory 
c:\windotvs o c:\winnt di un sistema Windo^s-Per attivare la libreria PDFIib dove- 
te aprire il file php.ini in un editor come Blocco note e poi trovare la riga seguente 
nel file: 

; extension=php_pdf . dll 

Per attivare la libreria è sufficiente rimuovere il ; dall'inizio della riga e salvare il fi- 
le. La Figura 32.1 illustra il file php.ini visualizzato in Blocco note. Ora siete pronti 
per iniziare a sviluppare con PDFIib. Per visualizzare l'output creato dagli script di 
questo capitolo dovetè procurarvi una copia di Adobe® Acrobat® Reader, disponi- 
bile presso www. adobe . it. 

Perché utilizzare PDFIib 

La libreria PDFIib e siala sviluppala per consentile la creazione di documenti PDF 
dinamici tramile il World \\ idi- Web K possibile creare un documento PDF che in- 
elude dati ricevuti da un utente Web provenienti da un database con capacità 
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'i php.ìni - Blocco note 




; extensi on=php_f ilepro. di 1 
extensi on=php_gd2 . al 1 
; extensi on=php_gettext. di 1 
; extensi on=php_fiyperwave. di 1 
; extensi on=php_i conv . di 1 
; extensi gn=php_ifx. dll 
; extensi on=ptìp_iisf une. dm 
; extensi on=php_imap. dll 
;extension=php_interbase. dll 
; extensi on=php_j ava. dll 
; extensi on=php_1dap. dll 
; extensi on=php_mbstr i ng. dll 
; extensi on=php_nicrypt . dll 
; extension=php_mhasn. dm 
; extensi on=php_mime_niagic. dll 
; extension=php_ming. d "Il 
; extension=php_mssq1 . dll 
;extension=php_msq"l. dll 
; extension=php_oci8. dm 
; extension«php_openss1 . dll 
; extension=php_bracle. dll 
ext ens i on=php_pdf .dll 
; extensi on=php_pgsq1 . dll 
; extension=php_pri nter . dll 
; extension=php_shmop. dll 
; extension=php_snmp. dll 
; extension=php_sockets.dn 
; extensi on=php_sybase_ct.d"n 
; extension=php_w32api . dll 
; extensi on=php_xm1rpc. dll 
; extensi on=php_xstt. di 1 
; extensi on=php_yaz. dll 
; extension=php_zip. dll 




Ti 




Figura 32.1 

Il file php.ini. 



lizzali In 



Web, il che significa che è possibile dar vita a documenti PDF personal 
modo dinamico. 

PDFlib si integra senza problemi in PHP, eliminando la necessità di seguire il U1 
dizionale percorso di creazione che dal postscript passa ad Acrobat Distiller e pi I 
al PDF. 

Inoltre è molto rapida e, quindi, ideale per la generazione di documenti dina 
ed è disponibile per diverse piattaforme, nonché per altri linguaggi di prog 
mazione oltre a PHP. La documentazione su PDFlib è disponibile al sito: www. p 
flib.com. 



Creazione del primo documento PDF j 

Per creare un documento PDF (anche il più semplice), è necessario seguire cinqui 
passaggi principali e introdurre diverse nuove funzioni. La prima cosa da fare è In 
dicare che si desidera iniziare a creare un documento PDF; ciò è possibile con 0 
funzione pdf _n ew ( ) . 
La sintassi della funzione è la seguente. 



int pdf_new(void) ; 




Creazione di documenti PDF 



399 



La tabella seguente descrive il tipo di valore restituito dalla funzione. 



Kl ...... 

nome 


Tipo 


Descrizione 


Restituzione di pdf_new( ) 


int 


La funzione restituisce un handle a un docu- 
mento PDF. Questo handle sarà utilizzato in 
tutte le funzioni successive che riguardano 
^wwiv Lii_^itu<_ uijcurnenio t l_Jr 


Hsempio di funzione: 




1 


$myPDF = pdf_new(); 







I fn volta ottenuto un riferimento (handle) per un documento PDF è necessario I 

\ tal line si utilizza la funzione pdf_open_f ile ( ) . 
Li sintassi della funzione è la seguente. 

Int pdf_open_file(int pdfHandle, string nomefile) 



l* tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione 



N ome Tipo Descrizione 



Pdf Handle - - ■-■ int 

nomefile string 

Hcsiituzione di pdf openf) int 



Handle del documento PDF che viene creato. 
Nome del file di documento PDF che viene 
creato. 

Restituisce TRUE se la funzione ha esito positi- 
vo o FALSE in caso contrario. 



Esempio di funzione: 

i»l f _open_f ile ($myPDF, " primo . pdf " ) ; v 

SS è tìS3P^ Un documento «àfe Però, al momento non contiene S 
Lfl sintassi della funzione è la seguente. 

void pdf_begin_page(int pdfHandle, doublé larghezza, doublé altezza); 

■ ■ Sheila seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



" 0m l Tipo Descrizione 

'htlqTefzl ÌH!k.ì Handle del documento PDF che viene creato, 

J , t 9 ezza ° U 6 Lar 8 hezza ddla P a 8i"a specificata in punti. 

Se «liSfone di , Alte2Za ddla pa 8 jna specificata in punti, 

e™ ' ge() V ° ld Non 



' lemplo di funzione: 

l!«lf _begin_page (SmyPDF , 595 , 842 ) ; 



La larghezza e l'altezza di una pagina sono specificate in punti, dove 1 punto equi- 
vale a 1/72 di pollice. Per fortuna, normalmente si creano pagine di dimensioni pre- 
stabilite, per esempio A4. La Tabella 32.1 fornisce la larghezza e l'altezza in punti 
dei formati di pagina più comuni: 



Tabel la 32. 1 Dimensioni delle pagi ne 



Dimensione pagina 



; 1 — 

Larghezza 



Altezza 



AO 


2380 


Al 


1684 


A2 


1190 


A3 


842 


A4 


595 


A5 


421 


A6 


297 


B5 


501 


Lettér 
Legai 


612 
612 



3368 
2380 

■ , _ > 



1190 

842 

595 

421 

709 

792 

1008 



Una volta creata la pagina, è possibile chiuderla con la funzione pdf_end_page( | 
(un segnale che si è finito di lavorare con essa). 



La sintassi della funzione è la seguente. 
Void pdf_end_page(int pdfHandle) 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 

/ 


Tipo 


Descrizione 


pdfHandle 


int 


Handle del documento PDF che viene crealo. 


Restiamone di 


void 


Non restituisce alcunché. 


pdf_end_page( ) 


■ 





Esempio di funzione: 



pdf end_page($myPDF) ; 

Una serie di chiamate ripetute a pdf_begin_page( ) e pdf_end_page( 
di dar vita a più di una pagina. L'ultimo passo nella creazione del docu 



chiamata alla funzione pdf dose ( ) . 
La sintassi della funzione è la seguente. 

void pdf_end_page(int pdfHandle) 



consente 
documento è In 



Nome 


Tipo 


Descrizione 


pdfHandle 


int 


Handle del documento PDF che viene crealo. 


Restituzione di pdf _close ( ) 


void 


Non restituisce alcunché, 



Creazione di documenti PDF 40 1 

La combinazione di queste funzioni in uno script PHP produce quanto segue: 
<?php 

// Documenti PDF - Esempio 32-1 

" ---.-.v 



$pageWidth=595; 
$pageHeight=842; 



$myPDF = pdf_new(); 

pdf_open_file($myPDF, "pdf / primo.pdf"); 

pdf _begin_page ($myPDF , $pageWidt h , SpageHeight ) ; 

pdf_end_page($myPDF) ; 
pdf_close($myPDF) ; 



?> 



<a href =" pdf /primo. pdf ">Visualizza il documento PDF generato. </a> 

Questo script include un collegamento ipertestuale che consente di visualizzare il 
file PDF nel browser Web. Se fate clic sul collegamento, Adobe Acrobat Reader ver- 
rà avviato e potrete vedere il documento appena generato. Sfortunatamente vedrete 
che questo documento PDF è costituito da una sola pagina vuota. Occorre pertanto 
introdurre alcune altre funzioni per poter avere documenti più interessanti. 

Inserimento di testo 

Per migliorare il documento PDF appena creato si può aggiungere del testo. A tal 
fine si farà ricorso a tre funzioni: pdf_f indf ont ( ), pdf_setf ont( ) e 
pdf_show_xy(). La P"ma di queste, pdf_f indf ont ( ), ha la sintassi seguente. 

int pdf_findfont(int pdfHandle, strina nomeFont, string codifica, int 
incorporato) • 



La tabella 




gomenti e il tipo di valore restituito dalla funzione. 



Nome 



Tipo 



Descrizione 



pdfHandle 
nomeFont 

codifica 



incorporato 



Restituzione di 
pdf_f indf ont ( 



int Handle del documento PDF che viene creato. 

string II nome del font da utilizzare. Tra i font più co- 

muni: "Times New Roman", "Arial" e "Courier". 

string Seleziona la particolare codifica dei caratteri per 

il font selezionato. La codifica è un codice nu- 
merico a 8 bit mappato con un carattere panico- 
lare nel set del font. Normalmente si utilizza il 
valore "host" per la stringa di codifica, in quanto 
seleziona il sistema di codifica appropriato per il 
sistema operativo del server. 

int Uno switch binario, dove 1 indica che il font sari 

incorporato nel documento PDF e 0 indica che 
non lo sarà. 

int Restituisce un handle per il font selezionato. Di 

seguilo trovate un esempio di questa funzione. 



Iìscmpio di l'unzione: 

Sarial = pdf_findfont($myPDF, "Arial", "host", 1); 

Questa istruzione creerà un font Arial che viene incorporato nel documento 
Una volta definito un font, si può scegliere di utilizzarlo con la funsi 
pdf_setfont(). 

La sintassi della funzione è la seguente, 

void pdf_setfont(int pdfHandle, int font, doublé dimensioneFont) 
La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla l'uii/imMl 



Nome Tipo Descrizione 

pdfHandle int Handle del documento PDF che vien< 

font int L'handle del font restituito dalla fu 

pdf_find_font(). 

dimensioneFont doublé La dimensione del font in punti. 

Restituzione di void Non restituisce alcunché. 
pdf_setfont( ) 

Esempio di funzione: 
pdf_setfont($myPDF, $arial, 12); 

Questa istruzione imposta il font Arial specificato in precedenza a una dimeiiM«i( 
di 12 punti. Ora è possibile scrivere del testo in un certa posizione della panimi, 
tal fine si utilizza la funzione pdf_show_xy. 
La sintassi della funzione è la seguente, 

void pdf_show_xy(int pdfHandle, string testo, doublé x, doublé y) 
La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun 

Nome Tipo Descrizione 



pdfHandle int 

testo string 

x doublé 

y doublé 

Restituzione di void 
pdf_show_xy( ) 



Handle del documento PDF che vicm- • fi I 

Il testo da visualizzare. 

La coordinata X sulla pagina. 

La coordinata Y sulla pagina. 

Non restituisce alcunché. 



Esempio di funzione: 

pdf_show_xy($myPDF, "Benvenuti nel mondo del PDF" ,70,700) ; 
Incorporando queste funzioni nello script precedente si ottiene quanto segui': 
<?php 

// Documenti PDF • Esempio 32-2 



l|)ii()eWidth=595; 
'•iM'i<!Height=842; 

Imyl'DF = pdf_new() ; 

pdf_open_file($myPDF, "pdf /secondo. pdf " ) ; 

m begin_page ( $myPDF , SpageWidth , $pageHeight ) ; 

lorial = pdf_findfont($myPDF, "Arial", "host", 1); 
pdf_setfont($myPDF, Sarial, 12); 

pdf_show_xy($myPDF, "Benvenuti nel mondo del PDF", 70,700); 

pc)f_end_page($myPDF) ; 
pdf_close{$myPDF) ; 




Output di testo in PDF. 



U Figura 32.2 mostra che il testo "Benvenuti nel mondo del PDF" è stato visualizza- 
P alla posizione 70 per 700 sulla pagina. 
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Righe di testo che fuoriescono dalla pagina 

Finora sembra andare tutto bene. Nell'esempio precedente siete riusciti a creare un 
documento PDF che contiene testo. Sfortunatamente, però, le cose non sono così 
semplici. Lo script che segue modifica l'esempio precedente allungando un po' il te 
sto e spostandone la posizione di inizio. 

<?php 



// Documenti PDF 
//•■■ 



Esempio 32-3 



$pageWidth=595; 
$pageHeight=842; 

$myPDF = pdf_new() ; 

pdf _open_f ile ( $myPDF , " pdf /terzo . pdf " ) ; 

pdf _begin_page ( $myPDF , $pageWidth , SpageHeight ) ; 

$arial = pdf_f indf ont($myPDF, "Arial", "host", 1); 
pdf_setfont($myPDF, $arial, 12); 

pdf_show_xy($myPDF, "Ciao a tutti e benvenuti nel mondo del PDF", 
400,700); 

pdf_end_page($myPDF) ; 
pdf_close($myPDF) ; 

?> 

<a href="pdf/terzo.pdf">Visualizza il documento PDF generato. </a> 

L'output di questo script è quello della Figura 32.3. Potete notare che la posizione X 
del testo sulla pagina è stata spostata alla posizione 400. Invece di inviare automali 
camente il testo alla riga successiva, esso è semplicemente fuoriuscito dal bordo 
della pagina. Purtroppo è così che funzionano i documenti PDF: dovete control la iv 
il posizionamento di tutto ciò che si trova sulla pagina, in quanto non esiste alcuna 
funzionalità di formattazione automatica come in un elaboratore di testi. Se volete 
essere certi che il testo che scrivete sulla pagina non fuoriesca dal bordo, dovetl 
scrivere il codice in modo tale che ciò non accada. 

m 



Formattazione di paragrafi di testo 

Sarebbe utile essere in grado di controllare l'output del testo sulla pagina, in modi » 
che tutto sia al suo posto e nessuna parte del testo scompaia fuori dal bordo. A lai 
fine dovreste costruire una riga di testo parola per parola, controllando che eiascu 
na parola aggiunta alla frase sia contenuta nella riga. Quando si raggiunge il limili-, 
la riga di parole dev'essere aggiunta alla pagina e occorre iniziare un'altra riga. Que- 
sta operazione dovrebbe essere ripetuta fino a quando tutte le parole sono state In 
serite nel l'ile. < )vvi;mienle, per poter agire in questo modo dovrebbe essere possihi 
le calcolare la l.n glie/za esatta di una parola in punti. Fortunatamente esiste una 
funzione chiamala pdf_8tringwidth( ) che si occupa di questo calcolo. 
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Figura 32.3 

Testo che fuoriesce dalla pagina. 



La sintassi della funzione è la seguente. 

doublé pdf_stringwidth{int pdfHandle, string laStringa); 

tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


pdfHandle 
laStringa 

Restituzione di 
pdf_stringwidth() 


int 

string 
doublé 


Handle del documento PDF che viene creato. 
La stringa di caratteri da misurare per ottenerne 
la larghezza esatta. 

La funzione restituisce la larghezza della stringa 
in punti come valore in virgola mobile. 


Esempio di funzione: 






pdf_stringwidth($pdf ,$line) ; 


■ 

-: 



Grazie a questa funzione è possibile essere certi che il testo sarà contenuto nella pagi- 
na. Lo script che segue illustra il metodo per la formattazione di un paragrafo di testo. 



c?php 



// Documenti PDF - Esempio 32-4 

m 



$text="Sopra la panca la capra campa, sotto la panca lo capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. "; 

$pointSize=16; 
$pagew"idth=595; 
$pageHeight=842; 
$lrMargin=80; 
$tbMargin=80; 

SlineWidth=$pageWidth- (SlrMargin*2) ; 
$textPos=$pageHeight-$tbMargin; 

$words = explodef" ",$text); 

$pdf = pdf_new( ) ; 

pdf _open_f ile ($pdf , " pdf /singlePara . pdf " ) ; 
pdf _begin_page ( Spdf , $pageWidth , $pageHeight ) ; 
$arial = pdf_f indfont($pdf , "Arial" , "host" ,1 ) ; 
pdf_setfont($pdf ,$arial,$pointSize) ; 

■;yv ' ■ '• '." . ■ • : ' .'' ' ' ' 

$lines = arrayC 1 "); 
$line=0; 

foreach (Swords as Sword) { Ul ..,.., 
if (pdf stringwidth (Spdf, Slines [Sline] . » " . $word) < $HneWidth){ 
$lines[$line] = $lines[$line] . Sword . " "; 

li > 

else { 

$line++; 

$lines[$line] = Sword . ■ «; 

} 

pdf_set_text_pos (Spdf , SlrMargin , SpageHeight -StbMargi 

foreach($lines as Saline) { 

pdf _show_xy (Spdf , Saline , SlrMargin , StextPos) ; 
$textPos=$textPos- ($pointSize+2) ; 

} 

pdf_end_page($pdf ) ; 
pdf _close (Spdf ) ; 

?> 

<a href="pdf /SinglePara. pdf ">Visualizza il documento PDF generato. </a> 

Lo script inizia dichiarando la stringa di testo che dovete visualizzare sulla pagina PDF: 

<?php 




// Documonu PDF • Esempio 32-4 



V_l UlilUI Ul UULUIMUILI I V-t\ IVI 



$text="Soppa la pano* la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. "; 

Vengono poi dichiarate variabili per rappresentare le dimensioni in punti del font, 
l'altezza e la larghezza della pagina, le dimensioni dei margini della pagina, la lar- 
ghezza massima di una riga di testo (tenendo conto dei margini) e infine la posizio- 
ne di partenza del testo. 

$pointSize=16j 

SpageWidth=595; 

$pageHeight=842; 

$lrMargin=80; 

StbMargin=80; 

$lineWidth=$pageWidth- (SlrMargin*2) ; 
StextPos=$pageHeight-$tbMargin; 

La stringa di testo viene quindi esplosa in un array per accedere a tutte le singole 
parole della frase. Le parole sono separate dal carattere spazio: 

Swords = explode(" ",$text)j 

La parte successiva dello script dichiara un nuovo documento PDF, gli dà un nome, 
inserisce una pagina e infine seleziona e assegna un font da utilizzare: 

Spdf = pdf_new( ) ; 

pdf_open_f ile (Spdf , "pdf /singlePara. pdf " ) ; 
pdf _begin_page (Spdf , SpageWidth , SpageHeight ) ; 
Sarial = pdf_findfont($pdf, "Arial" , "host" ,1 ); 
pdf _setf ont (Spdf , Sarial , SpointSize ) ; 



Con un ciclo f oreach, ogni parola contenuta nell'array Swords viene misurata e 
aggiunta alla fine di una frase. Quando la frase dovrà essere più lunga rispetto alla 
larghezza della pagina, viene memorizzata in un array chiamato lines e viene ini- 
ziata una nuova frase. Il risultato è che le singole parole dell'array Swords vengono 
combinate per formare un array di righe. Ciascuna frase è più corta rispetto alla tar- 
dezza di riga massima della pagina: 



Sword) < $lineWidth){ 



Slines = array (""); 
$line=0; 

f oreach (Swords as $word){ 

if (pdf_stringwidth (Spdf , Slines [Siine] . " 
$lines[$line] = $lines[$line] . Sword 

IKr" 

else { 
$line++; 

$lines[$line] = Sword . " " ; 

} 

> 



Infine, a partire dall'inizio della pagina, tutte le righe di testo contenute nell'array 
$lines vengono visualizzate sulla pagina, che poi viene chiusa e salvata: 

pdf _set_text_pos ( $pdf , SlrMargin , SpageHeight -StbMargin ) ; 

foreach($lines as Saline) { 

pdf _show_xy ($pdf , Saline ,$lrMargin , $textPos ) ; 
$textPos=$textPos- (SpointSize+2) ; 



pdf_end_page($pdf ) ; 
pdf_close($pdf ); 

?> ' >tu 

<a href =" pdf /SinglePara. pdf ">Visualizza il documento PDF generato. </a> 

L'output di questo script è quello della Figura 32.4. Lo script sembra funzionare 
molto bene, benché presenti alcuni svantaggi. Per esempio, lo script è in grado di 
gestire un solo paragrafo di testo e non ha alcun mezzo per separare i paragrafi. 
Inoltre, se il paragrafo dovesse risultare molto lungo, potrebbe scomparire oltre il 
fondo della pagina, in quanto lo script non ha alcun modo per aggiungere pagine al 
documento. È quindi il momento di pensare a uno script in grado di risolvere quesii 
problemi. 



'3http://localho5t/phpbook. 
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Sopra la panca la capra campa, sotto la panca la capra 
crepa. Sopra la panca la capra campa, sotto la panca la 
capra crepa. Sopra la panca la capra campa, sotto la panca 
la capra crepa. Sopra la panca 'la capra campa, sotto la 
panca la capra crepa. Sopra la panca la capra campa, sotto 
la panca la capra crepa. Sopra la panca la capra campa, 
sotto la panca la capra crepa. Sopra la panca la capra 
campa, sotto la panca la capra crepa. Sopra la panca la 
capra campa, sotto la panca la capra crepa. Sopra la panca 
la capra campa, sotto la panca la capra crepa. 




Figura 32.4 

Output di un singolo paragrafo. 




v . razione ai documenti PDf- 409 



Impaginazione di un documento di testo 

,16 script che segue è una modifica del precedente e lo migliora aggiungendo fun- 
zionalità per la gestione di paragrafi e pagine. Lo script inizia dichiarando due strin- 
gile eli testo. Osservate il carattere " \ n ", che sarà utilizzato come mezzo per rilevare 
1 inizio di un nuovo paragrafo. Le due stringhe sono concatenate assieme diverse 
volte per dar vita a una grande stringa chiamata $text. 

<?php 

// Documenti PDF - Esempio 32-5 

K*;------- - 



$text1= 


"Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. "'; 


$text2= 


'\n Sopra 


la panca 


la capra campa, __sotto 


la panca 


la capra creoa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. 




Sopra la 


panca 


la 


capra 


campa, 


sotto 


la 


panca 


la 


capra 


crepa. "; 




Stextl . 


$text2 . 


$text2 . $text2 . $text2 . $text2 . $text2 . 



$text2; 



La sezione seguente dello script è invariata rispetto all'esempio precedente: 

$pointSize=32; 

$pageWidth=595; 

$pageHeight=842; 

$lrMargin=80; 

$tbMargin=80; 

$lineWidth=$pageWidth - ($lrMargin*2 ) ; 
$textPos=$pageHeight.$tbMargin; 

Swords = explodet" \$t.xt)j 

Spdf = pdf _new(, ; 

pdf _open_f ile ($pdf , "pdf /paragraphs . pdf " ) ; 
pdf _begin_page (Spdf , $pageWidth , $pageHeight ) ; 
Serial = pdf_f indf ont (Spdf , "Arial" , "host" , 1 ) ; 
pdf_setf ont (Spdf , Sarial , SpointSize ) ; 



Quest'altra sezione dello script genera le righe di testo da \ Immite»»» Sulla pagina. 
È molto simile allo script precedente, ma óra contiene un'istruzione if aggiuntiva 
nel ciclo f oreach, che controlla la presenza di un carattere "Mi". Se lo trova, il ca- 
rattere " \ n" viene inserito nell'array $lines per indicare che dev'essere visualizza- 
ta una riga vuota: 

$lines = arr-ayC"'); 
$line=0; 

foreach($words as $word){ 
if($word == "\n"){ 
$line++; 

$lines[$line] = $word; 
$line++; 

$lines[$line] = ""; 

elseif(pdf_stringwidth($pdf ,$lines[$line] . " " . Sword) < $lineWidth){ 
$lines[$line] = $lines[$line] . $word . " "; 

} 

else { 
$line++; 

$lines[$line] = $word . " "; 

I > 

pdf _set_text_pos ( $pdf , SlrMargin , $pageHeight - StbMargin ) ; 

II ciclo f oreach che segue, che visualizza le righe di testo sulla pagina, ha subito 
due modifiche. Innanzitutto viene verificata la presenza di una riga costituita da 
" \ n". Se viene trovata, la variabile $textPos che viene utilizzata per memorizzare 
la posizione orizzontale del testo è ridotta di una riga di testo; questo ha l'effetto di 
•creare uno spazio tra i paragrafi: 

foreach($lines as $aline) { 
if (Saline == "\n"){ 

$textPos=$textPos- ($pointSize+2) ; 

} 

else { 

pdf _show_xy ($pdf , Saline , SlrMargin , StextPos) ; 
StextPos=$textPos-($pointSize+2) ; 

} 

Inoltre, viene controllato se la variabile $textPos è scesa al di sotto della posizione 
minima sulla pagina sulla quale si desidera visualizzare il testo. Se ciò accade, la pa- 
gina esistente viene chiusa e se ne apre una nuova per consentire la visualizzazione 
del testo: 



if (StextPos <= StbMargin){ 

StextPos=$pageHeight -StbMargin; 
pdf_end_page($pdf ) ; 

pdf _begin_page (Spdf , SpageWidth , SpageHe ight ) ; 

Sarial = pdf _findfont( Spdf , "Arial" , "host" , 1 ) ; 

pdf _setfont (Spdf ,Sarial,$pointSize) ; 

pdf 88t_text pos($pdf, SlrMargin, SpageHeight -StbMargin) ; 

} 



pdf_end_ |>ii(iu($pdf ) ; 
pdf_close($pdf ); 



?> 

<a href="pdf/paragraphs.pdf ">Visualizza il documento PDF generato. </a> 
>utput prodotto da questo script è quello delle Figure 32.5 e 32.6. 



Sopra la panca la capra 
campa, sotto la panca la 
capra crepa. Sopra la panca 
la capra campa, sotto la 
panca la capra crepa. Sopra 
la panca la capra campai- 
sotto la panca la capra crepa. 
Sopra la panca la capra 
campa, sotto la panca la 
capra crepa. Sop ra la panca 



Operazione completata , 

Figura 32.5 

Impaginazione di paragrafi con un font da 1 6 punti ... 




Osservate che il testo appare su più pagine. Siete liberi di regolare la dimensione 
per vedere se il testo appare correttamente. Le Figure 32.7 e 32,8 illustrano l'output 
prodotto dallo stesso script con la dimensione del font ridotta a 12 punti. 



Inserimento di immagini 



Per poter inserire immagini, è necessario introdurre diverse funzioni nuove, la pri- 
ma delle quali è pdf_open_image_f ile( ), che consente di specificare l'immagine 
Che si intende incorporare nel PDF. 
La sintassi della funzione è la seguente. 



int pdf_open_image_file(int pdfHandle, string tipoimmagine, string 
nomelmmagine) 
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Sopra la panca la capra 
campa, sotto la panca la 
capra crepa. Sopra la panca 
la capra campa, sotto la 
panca la capra crepa. Sopra 



la panca la capra campa, 
sotto la panca la capra crepa 
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Figura 32.6 

,.. il testo continua dalla pagina precedente. 
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Sopra la panca la capra campa, sotto la panca la capta crepa. Scora ta panca la 
capra campa, sor» la panca la capra crepa. Sopra la panca la capra campa, 
sotto la panca la caprai crepa. Sopra la panca la capra campa, sotto la panca la 
capra crcpa. Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. Sopre la panca la 
capra campa, sotto la panca la capra crepa. Sopra la panca la capra campa, 
sotto la panca la capra crepa Sopra la panca la capra campa, sotto la panca la 
capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. Sopra la panca la 
capra campa, soltn la panca la capra crepa. Sopra la panca la capra campa, 
sotto la panca la capra crepa. Sopra la panca la capra campa, sotto la panca la 
capra crepa. Sopra la panca la capra campa, sotto la panca la capra crepa. 
Sopra la panca la capra campa, sotto la panca la capra crepa. Sopra la panca la 
capra campa, sotto la panca la capra crepa. Sopra la panca la capra campa, 
sotto la panca la capra crepa. Sopra la panca la capra campa, sotto la panca la 
capra crepa. 
' 

Sopra la panca la capta campa, sotto la panca la capra crepa. Sopra la panca la 
capra campa, sotto la panca la capra crepa. Sopra la panca la capra campa, 
sotto la panca la capra crepa. Sopra la panca la capra campa, sotto la panca la 
capra crepa. Sopra la panca la capra campa, sono la panca la capra crepa. 



Sopra la panca la capra campa, aoilo la panc a la capra crepa. Sopra la panca la 
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Figura 32.7 

Impaginazione di paragrafi con un font da 1 2 punti 
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Sopra la panca la capra campa, sotto la panca ta capra crepa. Sopra la panca la 
capra campa, sotto la panca la capra crepa. Sopra la panca la capra campa, 
sono la panca la capra crepa Sopra la panca la capra campa, sotto la panca la 
capra crepa. 

Sopro la panca la capra campa, sono la panca la capra crepa. Scora la panca la 
capra campa, sotto la panca la copra crepa. Sopra la panca la capra campa, 
sotto la panca la capra crepa. Sopra la panca la crtpra campa, sotto la panca la 
capra crepa. Sopra la panca la capra campa, sotto la panca la capra crepa 
Sopra la panca la capra campa, sotto la panca la capra crepa Sopra la panca la 
capra campa, sotto la panca la capra crepa Sopra la panca la copra campa, 
sotto la panca la capra crepa. Sopra la panca la capra campa, sotto la panca la 
capra crepa. 

Sopra la panca la capra campa, sotto la panca la capra crepa. Sopra la parco la 
capra campa, sotto la panca la capra crepa. Sopra la panca la capra campa, 
setto la panca la capra crepa. Sopra la panca la capra campa, sotto la panca la 
capra crepa. Scora la panca la capra campa, sotto la panca la capra crepa 
Sopra la panca la capra campa, sotto la panca la capra crcpa. Sopra la panca la 
capra campa, sotto la panca la capra crepa. Sopra la panca la capra campa, 
sotto la panca la capra crepa. Sopra la panca la capra campa, sotto lo panca la 
capra crepa. 
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Figura 32.8 

... il testo continua dalla pagina precedente. 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


pdfHandle 


int 


Handle del documento PDF che viene creato. 


tipolmiìiagine 


string 


Tipo di file di immagine, che può essere png, 






gif, jpeg o tiff. 


nomelmmagine 


string 


Nome del file di immagine. 


Restituzione di 


int 


La funzione restituisce un handle per l'imma- 


pdf_open_image_f ile( ) 




gine. 



Esempio di funzione: 
■> 

Simage = pdf_open_image_f ile ($pdf, "jpeg ", "palma. jpg" ) ; 

Una volta selezionata l'immagine che si desidera utilizzare, è necessario determinar- 
ne la dimensione. pdf_get_value() è una funzione piuttosto versatile che restitu- 
isce i valori in una grande quantità di elementi in relazione ai parametri che le ven- 
gono forniti. 

{& sintassi della funzione è la seguente. 



float pdf_get_value(int pdfHandle, string parametro, int immagine) 



La tabella seguente descrive gli argomenti e il tipo di vdli IN "Mimilo dalla funzione. 



Nome 



Tipo 



Descrizione 



pdfHandle int 

parametro string 

immagine int 

Restituzione di f loat 
pdf_get_value() 



Handle del documento PDF che viene creato. 
Può essere imageheight o imagewidth. 
Handle dell'immagine restituito dalla funzione 
pdf_open_image_f ile ( ) . 
Restituisce la larghezza o l'altezza dell'immagine 
in punti. 



Esempio di funzione: 

$height = pdf_get_value($pdf, "imageheight" ,$image) ; 



La conoscenza della dimensione dell'immagine consente di collocarla nel punto de- 
siderato nella pagina. La funzione impiegata per collocare l'immagine sulla pagina è 
pdf_place_image(). 
La sintassi della funzione è la seguente. 

void pdf_place_image(int pdfHandle, int immagine, float x, float y, float 
scala) 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Descrizione 



Nome 


Tipo 


pdfHandle 


int 


immagine 


int 




float 


y 


float 


scala 


float 


Restituzione di 


void 



Handle del documento PDF che viene creato. 
Handle dell'immagine restituito dalla funzione 
pdf_open_image_f ile( ) . 
La coordinata X sulla pagina in cui verrà colloca- 
to l'angolo inferiore sinistro dell'immagine. 
La coordinata Y sulla pagina in cui verrà colloca- 
to l'angolo inferiore sinistro dell'immagine. 
Il fattore di scala. Un valore 1 visualizzerà l'im- 
magine a grandezza piena, 0.5 la visualizzerà 
con dimensioni dimezzate. 
Non restituisce alcunché. 



pdf_place_image(.) 



Esempio di funzione: 

pdf _place_image ( $pdf , $image ,100,100,1) ; 

Lo script che segue illustra l'utilizzo di queste funzioni per includere un'immagine 
in un documento PDF. Dato che per poter includere un'immagine nel documento 
ce ne occorre una, dobbiamo impiegare l'immagine palma.jpg: 



<?php 

// Documenti PDF - Esempio 32-6 



$pageWidth»595; 

$pageHeiQht-842; 

SlrMargin-eO; 



$tbMargin°80 ; 

$pos=$pageHeight-$tbMargin; 
$pdf = pdf_new() ; 

pdf_open_file($pdf , "pdf /picture.pdf ") ; 
pdf_begin page($pdf ,$pageWidth,$pageHeight) : 

$image = pdf_open_image_file($pdf , " jpeg" , " graphics/ palma. jpg" ) ; 
$height = pdf_get_value($pdf, "imageheight" ,$image) ; 
pdf_place_image($pdf ,$image,$lrMargin,$pos-$height, 1 ) ; 

pdf_end_page($pdf ) ; 
pdf_close($pdf ) ; 

?> 

<a href="pdf/picture.pdf ">Visualizza il documento PDF generato. </a> 

L'output prodotto da questo script è quello della Figura 32.9, che mostra come l'im- 
magine palma.jpg sia visualizzata nell'angolo superiore sinistro della pagina. 



3jhttp://localhost/phpbook/pdiypicture. 




Figura 32.9 

Un'immagine in un documento PDF. 



Creazione di proprie immagini 

La libreria PDFlib offre una grande quantità di funzioni clic consentono di creare 1 
propri elementi grafici in un documento PDF, tra cui forme e righe. Per fortuna, una 
volta compreso come creare un tipo di immagine, la creazione degli altri è un pro- 
cesso molto simile e richiede semplicemente la ricerca della funzione appropriata. 
Dopo aver letto queste pagine sarete in grado di creare righe e rettangoli. In PDF, la 
creazione di forme implica tre operazioni principali: definizione del colore, defini- 
zione della forma da visualizzare e visualizzazione di quest'ultima. La ftinzione 
pdf_setcolor( ) serve per definire un colore. 
La sintassi della funzione è la seguente. 

void pdf_setcolor(int pdfHandle, string tipo, string spazioColori, float 
r, float g, float b) 

La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione. 



Nome 



Tipo 



Descrizione 



pdfHandle 
tipo 

spazioColori 

!'r . ' 
9 

Wj ; . : 

Restituzione di pdf_setcolor() 



int Handle del documento PDF che viene 

creato. 

string Identifica la modalità di utilizzo del colo- 

re: "stroke" solo per il contorno, 
"fili" per riempire l'interno, "both" 
per entrambe le operazioni . 

string Specifica il metodo di definizione del co- 

lore. Si consiglia di utilizzare " rgb" . 

float Intensità del colore rosso. 

float Intensità del colore verde. 

float Intensità del colore blu. 

void Non restituisce alcunché. 



Esempio di funzione: 

pdf _set color ( $pdf , ■ st roke " , " rgb " , 0 , 0 , 255 / 255 ) ; 



Gli ultimi tre parametri consentono di specificare l'intensità dei colori rosso, verde e 
blu. I programmatori HTML sono abituati a specificare i colori sotto forma di triplet- 
ta RGB con valori compresi tra 0 e 255 per ciascuna combinazione di colori rosso, 
verde e blu. Sfortunatamente, pdf_setcolour( ) richiede che i valori di rosso, ver- 
de e blu siano specificati con un'intensità compresa tra 0 (nessuno) e 1 (100%). 
Niente paura, esiste una soluzione semplice. Supponete di voler specificare un co- 
lore verde lime che normalmente indichereste con i valori r,64;g,255.b,64: la solu- 
zione più semplice consiste nel dividerli per 255. 

La specificazione di una riga implica due funzioni: pdf_moveto( ) e 
pdf_lineto( ). La prima specifica l'inizio della riga, la seconda ne indica la fine. 
La sintassi delle funzioni è riportata di seguito. 

void Pdf_moveto(int pdfHandle, float x, float x) 
void Pdf_lineto(int pdfHandle, float x, float y) 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalle fun- 
zioni. 



Nome 



Tipo 



Descrizione 



pdfHandle 



x 

y 



Restituzione di pdf_moveto( 
e pdf_lineto( ) 



int Handle del documento PDF che viene 

creato. 

float La coordinata X sulla pagina, 

float La coordinata Y sulla pagina, 

void Non restituiscono alcun particolare va- 

lore. 



Esempio di funzione: 

pdf_moveto($pdf ,$lrMargin, 100) ; . 

pdf _lineto ($pdf , SpageWidth -$lrMargin , 1 00) ; 



Infine, per disegnare la riga si utilizza la funzione pdf _st roke ( ) , 
La sintassi della funzione è la seguente. 



void pdf_stroke(int pdfHandle) 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla fun- 
zione. 



Nome 


Tipo 


Descrizione 


pdfHandle 

Restrizione di pdf_stroke( ) 


int 

/ 

void 


Handle del documento PDF che viene 
creato. 

Non restituisce alcunché. 



Esempio di funzione: 
pdf_stroke($pdf ) ; 

I rettangoli vengono specificati e visualizzati in modo simile. Per specificare il ret- 
tangolo si utilizza la funzione pdf_rect ( ). 
La sintassi della funzione è la seguente. 

void pdf_rect(int pdfHandle, float x, float y, float larghezza, float 
altezza) 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla fun- 



/.ione. 







ome 



Tipo 



Descrizione 



df Handle 

x 
y 

larghezza 
Ut e zza 

Restituzione di pdf_roct( | 



int Handle del documento PDF che viene 

creato. 

' lo.it La coordinata X sulla pagina, 

i I n i i La coordinata Y sulla pagina. 

I Inni Larghezza del rettangolo, 

Vllezzii ilei rettangolo. 

Ni m restituisce alcunché, 



— - 



Esempio di funzione: 

pdf_rect($pdf ,$lrMargin+10,110,$pageWidth-($lrMargin*2) -20,$pageHeight- 
220); 

Per visualizzare il rettangolo sulla pagina si utilizza la funzione pdf _f ili 
stroke(). 

La sintassi della funzione è la seguente, 
void pdf_fill_stroke(int pdfHandle) 



La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


pdfHandle 


int 


Handle del documento PDF che viene crea- 
to. 

Non restituisce alcunché. 


Restituzione di 
pdf_fill_stroke() 


void 



Esempio di funzione: 



pdf_f ill_stroke($pdf ) ; 

Lo script seguente illustra l'utilizzo di queste funzioni con un semplice esempio. Lo 
script produce un documento costituito da una pagina con due righe ih alto e in 
basso e un grande rettangolo rosa: 

■ 

<?php 

// Documenti PDF • Esempio 32-7 

$pageWidth=595; 
$pageHeight=842; 
$lrMargin=80; 
$tbMargin=80; 

$pos=$pageHeight-$tbMargin; 
$pdf = pdf_new(); 

pdf_open_file($pdf , "pdf / linerect.pdf ") ; 

pdf _begin_page ($pdf , $pageWidth , $pageHeight ) ; 

pdf_setcolor($pdf , "stroke" , " rgb" ,0,0,255/255) ; 

pdf_moveto($pdf ,$lrWlargin,100) ; 

pdf _lineto ($pdf , SpageWidth -$lrMargin , 1 00) ; 

pdf_stroke($pdf); 

pdf jnoveto ( $pdf , $lrMargin , $pageHeight - 1 00 ) ; 

pdf _lineto ($pdf , $pageWidth -$lrMargin , $pageHeight - 100) ; 

pdf_stroke($pdf ) ; 

pdf .setcolor ( $pdf , " both » , " rgb » , 233 / 255 , 1 57 / 255 , 1 57 / 255 ) ; 



pdf_rect($pdf ,SlrMargin+10, 110, SpageWidth - ($lrMargin*2) -20,$pageHeight-220) ; 
pdf_fill_stroke($pdf); 

pdf_end_page($pdf ) ; 
pdf_close($pdf); 

?> • •: . 

<a href="pdf /linerect.pdf ">Visualizza il documento PDF generato. </a> 

L'output di questo script è quello della Figura 32.10. 



-3http://li>calho5t/phpbook/pdf/linerect.pdf - Micro: 
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Questo capitolo ha introdotto alcune Funzioni che fanno parte della libreria PDFLib. 
Si è visto come sia possibili- i ivan sciupili i dot umenti PDF e come superare alcu- 
ne difficoltà poste dalla lomiauazlnne ili qucMi documenti. Il prossimo capitolo si 
occuperà di database relazionali i di Un prou,otla/ionc di tabelle. 



Capitolo 33 

Database e struttura 
delle tabelle 

Introduzione 



In questo capitolo verranno illustrati i sistemi di gestione di database relazionali, i 
database, le tabelle, i campi delle colonne e i record. Nei punti più appropriati si 
farà riferimento al sistema di gestione di database MySQL, poiché è quello che sarà 
utilizzato più avanti per gestire i database. 



Definizione di database 

Un database è una collezione strutturata di dati, che in quanto tale esisteva molto 
prima dell'invenzione del computer. Ecco alcuni esempi di database del "mondo 



• una guida con 1 programmi televisivi; 

• un classificatore per l'archiviazione di documenti; 

• una rubrica telefonica. 

Un database informatico è uno strumento per memorizzare in forma strutturata in- 
formazioni che potranno essere recuperate e analizzate velocemente e facilmente. 
Ecco alcuni esempi di database informatici: 

• DVLA (.Driver and Vehicle Licensing Agency) che registra le informazioni re- 
lative a tutti i veicoli immatricolati nel Regno Unito; 

• HOLMES (Home Office Large Major Enquiry System) che memorizza i dati 
relativi a criminali e persone sospette coinvolti in investigazioni attuali e 
passate della polizia; 

• Amazon.com, un database di libri da vendere collegato a un sito di com- 
mercio elettronico. 

Tutti questi database sono molto grandi, ma il concetto rimane sempre lo stesso a 
prescindere dalle dimensioni, 
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Sistema di gestione di database 

Un sistema di gestione di database, o DBMS (Database Management System), è il 
software che agevola la creazione e la gestione di un database informatico. In gene- 
rale, un DBMS esegue i seguenti compiti: 

• gestisce una grande quantità di dati; 

• fornisce l'accesso ai dati con un linguaggio di interrogazione; 

• fornisce una certa protezione per i dati; 

• consente accessi multipli al database. 

MySQL è un DBMS relazionale. Un database relazionale memorizza i dati in tabelle 
separate invece che in un unico archivio. In teoria, questa soluzione dà vita a un si- 
stema di database più veloce e flessibile. , 



■ 



Tabella di database? 

Una tabella di database è molto simile a una tabella inserita in un documento di 
elaborazione testi, poiché è composta da righe e colonne. Spesso le colonne 
prendono anche il nome di "campi" e sono utilizzate per delimitare la struttura dei 
dati nell'ordine corretto. Nelle righe di una tabella del database sono memorizzati 
i record. All'interno di un database specifico, a una tabella viene assegnato un 
nome univoco. 

La Figura 33.1 illustra una semplice tabella di database. 




Womg tgbella 



Tabella: automobili 



|— Campi 
colonna 



idAutomobile 


marca 


modello 


colore 











^Hecoro 



Figura 33.1 

Tabella di database. 

Nella Figura 33.1 potete vedere che la tabella del database si chiama "automobili" 
ed è costituita da quattro campi: idAutomobile, marca, modello e colore. Nella ta- 
bella non ci sono record di dati. 



Campi del database 

I campi del database definiscono la struttura dei dati contenuti in una tabella. Come 
le variabili, anche i campi del database possono essere di tipi diversi. A complicare 
leggermente la situazione contribuisce il fatto che i tipi di campo non sempre sono 
gli stessi del linguaggio di programmazione utilizzato per accedere al database. Nel 
sistema di gestione di database MySQL è possibile definire tipi di campo diversi. 
Questi tipi di campo sono elencati nelle Tabelle 33-1-33.3. 



Tabella 33. 1 Tipi di campo testuali 



Tipo 



_ ezza massima 



Descrizione 





varchar 
char 
:inytext 



text 
mediumtext 
longtext 
enum 



255 caratteri 
255 caratteri 
255 caratteri 
65.535 caratteri 
16.777.215 caratteri 
4.294.967.295 caratteri 
65.535 caratteri 



Campo di testo 
Campo di testo 
Campo di testo 
Campo di testo 
Campo di testo 
Campo di testo 
Valor: 



a lunghezza variabile, 
a lunghezza fissa, 
a lunghezza variabile, 
a lunghezza variabile, 
a lunghezza variabile, 
a lunghezza variabile, 
di un campo di testo. 



Tabella 33.2 Tipi di campo numerici 



Tipo 



Dimensione numerica Descrizione 



int 

tinyint 
mediumint 
bigint 
float 

doublé 

acimai 



4.294.967.295 
255 

16.777.215 
18.446.744.073.709 



Campo numerico con o senza segno. 
Campo numerico con o senza segno. 
Campo numerico con o senza segno. 
Campo numerico con o senza segno. 
Campo numerico in virgola mobile con se- 
gno. 

Campo numerico in virgola mobile con se- 
gno. 

Campo numerico con segno (numeri me- 
morizzati come caratteri). 







■ 




Tabella 33.3 


Tipi di campo data e ora 






Tipo 


Valori 


Descrizione 





date 


Dal 01-01-1001 


Memorizza i dati in un formato YYYY-MM- 




al 31-12-9999 


DD (anno-mese-giorno) 


time 


Da -838:59:59 a 838:59=59 


Memorizza i dati in un formato ora 


datetime 


Dalle 00:00:00 


Memorizza i dati in un fonnato YYYY-MM- 




del 01-01-1001 alle 


DD HH:MM:SS (anno-mese-giorno oremii- 




23:59:59 del 31-12-9999 


nuti:secondi) 


timestamp 


2-14 


Memorizza i valori numerici per presentare 
diversi tipi di indicatori data e ora UNIX 


year 


dal 1901 al 2155 


Memorizza quattro cifre (o due) per presen- 
tare l'anno. 
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La Figura 33.2 mostra la tabella del database modificata m modo da specificare il 
tipo di ciascun campo. 



Tabella: automobili 



I 



Nome tabella 



X 



idAutomobile 
lnt(11) 


marca 
varchar(40) 


modello 
varchar(40) 


colore 
varchar(40) 












; 








|— Campi 
colonna 



— Record 



Figura 33.2 

Tabella del database con i tipi di campi. 

Il campo idAutomobile è di tipo intero e può memorizzare numeri di 11 cifre. I cam- 
pi marca, modello e colore sono tutti del tipo varchar, con una dimensione massi 
ma di 40 caratteri. 



Attributi speciali dei campi e chiavi 

Oltre al tipo, per un campo è possibile specificare anche alcuni attributi speciali, 
elencati nella Tabella 33-4. Tali attributi descrivono alcune proprietà speciali del 
campo. 

Tabella 33.4 Attributi speciali 
Attributo Descrizione 

autoincrenent II valore del campo viene creato automaticamente insieme a un nuovo 
record. Tale record non è fornito dall'utente. Questo attributo serve so 
prattutto a garantire la creazione di un valore di campo univoco, poi- 
ché il valore prodotto è maggiore di uno rispetto all'ultimo creato. 

not nuli II campo del database non può essere vuoto. Se è vuoto, viene genera- 

to un errore. 

default Questo attributo specifica il valore cui verrà impostato il campo se non 
si fornisce alcun valore. 

Campi univoci 

È possibile specificare un campo come univoco. In altre parole, in una tabella non 
ci possono essere due record con lo stesso valore nel campo. Un esempio potrebbe 
essere una tabella contenente un elenco con nomi di persone e codici fiscali. Anche 
se due persi me pi issono avere lo stesso nome, non pi issi mi i av ere il medesimo co- 



Chiavi 



I campi di una tabella possono essere specificati come chiavi primarie. Una chiave 
primaria serve a creare un indice dei record del database all'interno di una tabella. 
La chiave primaria dev'essere anch'essa univoca, tuttavia oltre a ciò viene generato 
un indice della tabella che consente ricerche e recuperi di record molto più rapidi. 

Record del database 



I record del database (noti anche con il nome di righe) formano le righe della tabel- 
la del database. I record devono corrispondere al tipo e agli attributi speciali di 
scun campo. La Figura 33-3 mostra la tabella del database con tre record. 



Nome tabella 



Tabella: automobili 



IdAutomobile 
lnt(11) 


marca 
varchar(40) 


modello 
varchar(40) 


colore 
varchar(40) 


1 


Ford 


i 

Focus 


Blu 


2 


Ford 


Fiesta 


Verde 


3 


Mazda 


323 


Nera 



(— Campì 
colonna 



■ Record 



Figura 33.3 

Record della tabella del database. 

tiepilogo 

Questo capitolo ha spiegato che cos'è un database e un sistema di gestione di data- 
base. Ha illustrato inoltre il concetto di tabella del database e descritto i vari tipi di 
campi disponibili in MySQL. Nel prossimo capitolo vedrete come installare il siste- 
ma di gestione del database MySQL e il software PHPMyAdmin. 



/ 




















Capitolo 34 

Installazione del database 
MySQL e di PHPMyAdmin 

■ 



Introduzione 

Questo capitolo descrive come procurarsi, installare e configurare il sistema di ge- 
stione di database MySQL. Stando a quanto afferma il sito Web di MySQL, "MySQL è 
il server di database open source più diffuso, con oltre quattro milioni di installazio- 
ni a supporto di siti Web, banche dati, applicazioni aziendali, sistemi di registrazio- 
ne e altro ancora. Organizzazioni come Yahoo!, Finance, MP3.com, Motorola, 
NASA, Silicon Graphics e Texas Instruments utilizzano il server MySQL per applica- 
zioni mission-critical". Uno tra i maggior pregi di MySQL è la possibilità di scaricarlo 
e utilizzarlo gratuitamente. 

Benché MySQL sia un database molto potente con numerose funzionalità (normal- 
mente offerte solo da prodotti commerciali molto costosi), è penalizzato dal fatto di 
non offrire un'interfaccia grafica di agevole utilizzo. Tuttavia non tutto è perduto, in 
quanto il progetto PHPMyAdmin offre uno strumento molto sofisticato e di facile 
impiego, scritto in PHP, concepito per gestire l'amministrazione di MySQL attraver- 
so il World Wide Web. In queste pagine si farà ricorso sia a MySQL sia a PHPMyAd- 
min per creare le applicazioni di database utilizzate negli esempi. Per cominciare 
imparerete come procurarvi MySQL. 

Scaricamento di MySQL 

MySQL può essere scaricato gratuitamente dal sito www.mysql.com. È preferibile 
scaricare l'ultima release stabile da http://www.mysql.com/downloads/mysql- 
4.0. html. Esistono molte versioni per diversi sistemi operativi, quindi dovete ac- 
certarvi di selezionare quella giusta. 

Se desiderate scaricare MySQL per utilizzarlo su una piattaforma Windows, potete 
scegliere di procurarvi un pacchetto di applicazioni PHP completo presso l'AppServ 
Open Project all'indirizzo http://appserv.sourceforge.net/. Questo pacchet- 
to include l'ultima versione stallile di MySQL e PHPMyAdmin. Nel Capitolo 3 sono 
stati discussi ulteriori dettagli telativi a questo pacchetto di applicazioni. 
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Installazione del server MySQL 
(su server Linux/UNIX) 

1 

Se state installando MySQL su una piattaforma Windows, o se il provider di servizi o 
l'amministratore di sistema hanno già installato e configurato MySQL, potete ignora- 
re questo paragrafo. 

Istruzioni da seguire per installare il database MySQL su un server UNIX. 

1. Accedete al server con il nome utente "root". 

2. Scompattate tutti i file sorgente: 

[root@server root]# tar -xzf mysql-4.0. 13.tar.gz 

3. Cambiate la directory di lavorò corrente in mysql-4.0. 13- 
[rootOserver root]# ed mysql-4.0. 13 

4. Configurate il server MySQL: 

[ root @s e rver root]# ./configure - - pref ix=/usr/local/mysql 

5. Compilate e installate il server MySQL: 



[root@server root]# make 



[root@server root]# make instali 

6. Installate il database MySQL principale: 
[root@server root]# . /scripts/mysql_install_db 

7. Create un link simbolico all'eseguibile mysqld: 

[root@server root]# In -s /usr/local/mysql/sfiare/mysql/ 
mysql. server /sbin /mysqld 

.8. Create un gruppo mysql: 

[root@server root]# groupadd mysql 
9. Create un utente mysql: 

[root@server root]# useradd -g mysql mysql 
10. Create i proprietari appropriati: 

[root@server root]# chown -R mysql:mysql /usr/local/mysql 

A questo punto potete avviare, arrestare e riawiare MySQL digitando quanto 
segue: 

[ rootOserver root]# mysqld start 
[root@server root]# mysqld stop 
[root@server root]# mysqld" restart 

Potete disinstallare MySQL applicando le seguenti istruzioni: 

[root@server root]# rm -rf /usr/local/mysql 
[root@server root]# rm -rf /data/mysql 
[root@server root]# rm -rf /sbin/mysqld 
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Installazione del server MySQL 
(su server Windows) 

■ ' ■ ■ . . ■ 

Se avete scaricato MySQL come parte dell'AppServ Open Project, o se il provider di 
servizi o l'amministratore di sistema hanno già installato e configurato MySQL, pote- 
te ignorare questo paragrafo. 

Istruzioni da seguire per installare il database MySQL su un sistema Windows. 

1. Decomprimete il file zip di MySQL in una directory temporanea. 

2. Eseguite il file setup.exe e seguite le istruzioni che appaiono sul monitor. 

3. L'applicazione MySQL può essere configurata per essere avviata ed eseguita 
automaticamente in background all'avvio del computer. Si consiglia di sele- 
zionare questa opzione. 

Installazione di PHPMyAdmin 

PHPMyAdmin è un'applicazione scritta con PHP ed è pertanto indipendente dalla 
piattaforma. Non dovete quindi preoccuparvi di procurare diverse versioni per i vari 
sistemi operativi. Per installare PHPMyAdmin dovete scaricare il pacchetto comple- 
to dal sito http: / /www. phpmyadmin .net/. Dovete poi decomprimere i file in una 
directoiy appropriata e modificare il file config.inc.php fornito con PHPMyAdmin in 
modo che le impostazioni corrispondano con quelle del database. 
Per scaricare l'ultima versione di PHPMyAdmin, visitate l'URL http: //phpmyad- 
min. sourceforge.net/. Benché le funzionalità siano le stesse sia per Linux, sia 
per Windows, dovete selezionare il file di installazione compattato in maniera com- 
patibile con il vostro sistema operativo: per un server Linux dovrete scegliere un file 
in formato .tar.gz, mentre per i sistemi Windows vi occorrerà il file .zip. 



Configurazione di PHPMyAdmin 

1. Decomprimete tutti i file in un cartella Web (una cartella che può essere 
visualizzata tramite il Web), come per esempio: C:\lnetpub\wwwroot\ 
phpMyAdmin\. 

2. Nel file config.inc.php, situato nella cartella OXlnetpub\wwtvroo?\phpM- 
yAdmin\ cambiate le righe seguenti: 

$cfg[ 'PmaAbsoluteUri' ]= 1 http: //localhost/phpMyAdmin/ 1 ; 
$cf g [ ' Servers ' ] [ $i ] [ ' auth_type ' ] = ' http ' ; 
$cf g [ 1 Servers 1 ] [ $i ] [ 1 user 1 ] = 1 nomeutente 1 ; 

Questa configurazioni- dovrebbe consentirvi di accedere e fornire un nome 
utente e una password l'uit.ivia, nel caso in cui non funzioni, è possibile 
forzare un accesso con [e lmp< (Minzioni seguenti: 



$cfg[ 'Servers' || •uth.typf |-'oonfig' ; 
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$cfg[ 'Servers' ] [$i] [ 'user' ] = ' root' ; 
$cfg[ 'Servers' ] [$i] [ 'password' ]=" ; 

11 campo password includerà la password che selezionerete più avanti nella 
configurazione dell'account dell'utente root. Per ora lasciatelo vuoto; sarete 
avvertiti quando arriverà il momento di cambiare l'impostazione. Sappiate 
comunque che l'inserimento di password in questo file ini è un rischio per 
la sicurezza del sistema. La Figura 34.1 illustra il file config.inc.php. 



fij config.inc.php - Blocco not 



Modifica Formato 



**** 



" Disable the default warning that is displayed on the db Details structure page 

* any of the required Tables for the relationfeatures could not be found 

$cf'g['PniaNoRelaTion_Disablewarning'] = false; 

/** 
<■ The 
" at 1 

* pass 

V 

$cfg['blowfish_secret' ] - "'; 



'cookie' auth_type uses biowflsh algorithm to encrypt the password, if 
east one server conf iguration uses cookie' auth_type, enter here a 
phrase that will be used by biowflsh. 



/Hit 

* server(s) configuration 
V 
$i » 0; 

// The $cfg['servers'] array starts 
// You can disable a server config 



Ji++ 
$cfg 
$cfg 
$cfg 
$cfg 
$cfg 



with $cfg[' servers '] [1] . 
entry by satting host to 



DO 



' ser 



[ servers . 




■$ì: 




['servers' ; 




li 




'servers'; 




$i; 




'servers'; 




"Si- 




['servers ' . 




Si 





' host ' ] 

socket ] 
' connect_type ' ] 



IP addres 
e blank fc 



$cfg[' Servers ' ] [$i ] ['control user ' ] 
$cfg[' servers'] [$i] [ ' controlpass ' ] 

. 

$cfg[' servers'] [$i] [' auth_type'] 
$cfg[' servers'] [$i] [' user'] 



' 1 ocalhost ' ; // MySQL hostname or - 
''; // MySQL port - leave , ^ 

"'; // Path to the socket - leave 

'tcp'; // how to connect to MySQL ser 

false; // use compressed protocol for 

// (requires PHP >= 4.3.0)^ 
''; //MySQL control user settings 

// (this user must have read-c 
' '; : , // access to the "mysql/user" | 

// and "raysql/db" tables). 
// The controluser is also 
// used for ali relational 
// features (pmadb) 1 
'/ Authentication method (conf 
'/ MySQL user 



= 'config 
= 'root ' ; 




Figura 34.1 

Modifica del file config.inc.php. 

Accesso a PHPMyAdmin 

L'accesso a PHPMyAdmin avviene dalPURL inserito in precedenza nel file con- 
fig.inc.php: http: //localhost/ phpMyAdmin/ index. php. Dovreste trovarvi di 
fronte a una pagina Web simile a quella della Figura 34.2. 



Configurazione di utente root e host in MySQL 



Quando si a\ \ ia il server MySQL, vengono creali quattro utenti predefiniti. L'elenco 
degli utenti vtolblk selezionando il collegamento ' lenii o Priviteli Ca seconda che 



installazione dei aataoase nyav^L e ai rr-irnyMamin 




Figura 34.2 

La pagina principale di PHPMyAdmin. 



utilizziate Linux o Windows) dalla schermata della Figura 34.2. La schermata degli 
utenti è illustrata nella Figura 34.3. Dovete eliminare i primi tre utenti (come mostra- 
to nella Figura 34.3) e lasciare solo l'utente "root" con l'host impostato su "lo- 
calhost". Per togliere gli utenti, selezionate la casella di spunta accanto ai primi tre 
elementi dell'elenco e fate clic sul pulsante Esegui sotto la tabella. 
Dopo aver fatto clic su questo pulsante, vi troverete di fronte alla schermata della 
Figura 34.4. Ora siete pronti per aggiungere una password all'utente "root". Fate 
scorrere verso il basso la pagina fino al punto in cliì vedete Vista d'insieme 
dell'utente e fate clic sul collegamento Modifica accanto all'unico utente presente 
nella tabella, che è l'utente root. Dovreste vedere la schermata di modifica dei privi- 
legi della Figura 34.5- Facendo scorrere verso il basso la schermata vedrete i campi 
del modulo nei quali dovete inserire la password (due volte). Scorrete e fate clic sul 
pulsante Esegui. 

Facendo clic sulla scheda Primlegi in cima alla schermata tornerete all'elenco degli 
utenti (ora solo uno) e dovreste vedere che per l'utente è stata impostata una pass- 
word (come mostrato nella Figura 34.6). A questo punto dovrete tornare indietro e 
modificare il file config.inc.php per includere la password che avete impostato (ma 
solo se avete dovuto impostare la variabile "authjype" su "config"): 



$cf g [ ' Servers ' ] [ $i 1 1 ' password ' ) - ' password 1 ; 




selezionare 
un database 

— 



Vista d'insieme dell'utente 





Utente 

iuaisiiSi 


Host Password 


Privilegi globali 

USAOE 


p 


p. 


Qualsiasi 


ocalhost ivo 




SELECT, INSERT, OPDATE, DILITE, 
CREATE, DROP, RELOAD, SHUTDOVN, 
PROCESS, FILE, REFEPENCES, INDEX, 

ALTER ,; i 


p 


root 


filici 




ALL PRIVILECES 


r 


root 


ocalhost Ho 




ALI, PRIV3LEGE3 



Finesi:ra de lla Quer. 



Nota: ì nomi dei privilegi di M/SQL &dho in inglese 
— Seleziona lutti / Deseleziona tutti 

• Aggiungi un nuovo utente 



Rimuove gli utenti selezionati 

f 7 Cancella soltanto gli utenti dalle tabelle dei privilegi. 
O Revoca tutti i privilegi aitivi agli utenti e dopo li cancella. 

O. Cancella ali utenti e dono ricaricai orivileaL 

HHÉliijBBH 







Grant 


Aijone 

Modifica 


No 


Si 


MorJilica 


s. 


Modifica 




Modifica : 




§3 
! 




t 11 



Figura 34.3 

La pagina degli utenti con quattro utenti MySQL predefiniti. 




' 3(phpMyAdniÌn in ese cuzione su locolliosf: - phnMyAdmtn 2.5,& - Microsoft Intoi 



-fa Mooìfca VBi 
^Indetto - <* ■ 

idiftao f^fwpi/^ocalhosl/ hpHvfldTin/index.php 



| (Database) ...^ 



Prego, selezionare 
un database 



..della cuery 




Server localhost 

Gli utenti selezionati sono stati cancellati con successo. 

query SOL : 

# CanceilazlQiiG'irì torso di 

DELETE FROM 'usVWHBK User' = - AND 'Hosl '-"»'; 

DELETE FROM db'WHERE 'Use-' AND 'Hosl ' 

DELETE FROM tableejw' WHEHE 'User' - "' AND Host' = 

DELETE FROM 'Cpiùmn.sjwiy' WHERE User' = ".' AND Hosl - 

t ùancetlnribrje tu r.oiso di 'igTocalliosi' . 
DELETE FROM 'user'WHERE 'User' - "AND Host i'iocalhosr: 

DELETE FROM 'ob'WHHNE 'User. ='."■ AND T lcs!' s"irB8ih03f\ 

DELETE FROM 'tahl!i£:_pra WHERE 'User - '"AND 'Hosl i-'Tccalhos!" 

• ■l)Ber*'" ; Ar(D Mosi' - idcaihoi-r; 




s r. i-nt!l;,;iw( i i. i ■vSi 
DELETE FROM USS'" WHERE 'Usw 

bELÉTEFRÒM (io'WHEFìE 'User 



of AND 'Hosl' ■%•, 
" AND 'Host - "%•; 



Figura 34.4 

Schermata degli utenti eliminati. 



installazione dei database nybQL e di mPNyAdmin 435 



3| phpMyAdmln In c scoiai or <>u looillioit - phpMyAdmfn 



Modifica «iualtea Preferii! ir.jnitr.fi ? 



-|g|x| 



Indliireo |;é]htto:/;iocaUil/proMyAtlniin/rideii.pFe 




Server localhost 

.so l g 



Utente 'root'@'localhost' 
• Modifica Privilegi 

Mote:/ no*! </ei ptivitegi tf 1 M/SOL 



Privilegi globali 

0 If7figtn.it 



Dati 


Struttura 


Amministrazione 


P SELECT 


P 


CREATE 


P 


GRANT 


P INSERT 


P 


ALTER 


P 


SUPER 


P UPDATE 


P 


INDEX 


P 


PROCESS 


P DELETE 




pbop j^9BBHWW 


P 


RELOAD 


p FILE 


17 


CREATE TEMPORARY TABLES 


P 


SBUTDOOM 




1 imiti i'; 


P 


SHOB : DATABASES 




P 


LOCK TABLES 


MAX QUERIES PER HOUR |0 


P 


REFERENCES 


MAX UPDATES PER HOUR |u 


P 
n 


EXECUTE 



1 I M Irata 



Figura 34.5 

Modifica della password. 
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: //tocalhost/phpMvAdininflndex .ohp 



Home 

| (Database) ,..^J 




Server localhost 

La password per l'utente 'ront'@'localhost'è cambiata con successo. 



j Databa se \ Stato | | Variabili 

Utente 'roof , @7oca/riosi' 



Processi j I Esporta [ 



. Modifica Privilegi 

%0i 



Privilegi globali 

I 11 «ySfft sono ìf> **)l«s« 



amministrazione 




Figura 34.6 

La pagina degli utenti con l'amminiitratoro root appropriato. 



Aggiunta o modifica di utenti MySQL 

PWF connettersi a uno o più dalaba.se, e necessario fornire un rome utente e una 
password per consentire agli script PHP cii accedere ai server di database MySQL ed 
effettuare le query appropriate per recuperare i dati. Per ragioni di sicurezza e ac- 
cessibilità, si consiglia vivamente di creare un nuovo utente per i database che de- 
vono essere utilizzati dalla stessa persona p silo. In PHPMyAdmin questa operazio- 
ne è molto .semplice Innanzi uillo fate clic sul pulsante Aggiorna del browser per 
tornare alla schermata principale. Poi fate clic sul collegamento Utenti o Privilegi, 
fate sconcie la pagina fino al collegamento Aggiungi un nuovo niente e seleziona- 
telo. La Figura 34.7 illustra la schermata die dovrebbe comparire. Quando si ag- 
giunge un nuovo utente, é necessario compilare quattro aree. 

1. Hosts in questo campo è necessario fornire un nome di host Cene rappre- 
senta Phost da cui un database MySQL consentir:! l'accesso). Se l'opzione 
selezionata è Qualsiasi host. la connessione a MySQL può avvenire a livello 
locale o tramile un server remoto. Se l'opzione è impostala a lucale, le con- 
nessioni a MySQL sono limitate agli utenti locali, 

2. Nome utente: in questo campo è necessario fornire un nome utente. Non 
utilizzate l'opzione Qualsiasi niente. 

3. Password: password associala al nome utente indicato Tutte le password 
vengono cifrate «in il metodo crittografico MD5, tuttavia per la massima sicu- 
rezza devono essere lunghe otto o più caratteri e contenere simboli e numeri. 



l'vMTAtlnwi in c'rcuiloncHjkH^oil-pIv^fA^BnZJjb-MlirrowR. Internet I mitare* 
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Figura 34.7 

Aggiunta di un nuovo utente MySQL. 
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4. Privilegi: i privilegi devono essere sempre lasciati deselezionali quando si 
crea un semplice utente. Questi non hanno nulla a che vedere con i privile- 
gi del database, in quanto riguardano le autorizzazioni globali di un utente 
per il server di database MySQL. Se state creando un secondo amministrato- 
re root, devono essere selezionati tutti, 



Creazione di un database 



La creazione di un nuovo database è un'operazione molto semplice. Dalla scherma- 
ta principale di PHPMyAdmin dovete semplicemente inserire il nome del database 
da creare nel campo del modulo e fare clic sili pulsante Crea. Provate a creare un 
itabase di nome "mio_databasc" e poi late clic sul pulsante Crea-, dovreste vedere 
la schermata simile a quella della Figura 34.8, che consente di aggiungere tabelle 
al database. Una tabella è il luogo in cui vengono memorizzati i dati in un database 
relazionale. Gii altri sistemi di gestione dei database memorizzano le informazioni 
in una sola grande area, ma non è così che funzionano i database relazionali. Questi 
ultimi infatti utilizzano più tabelle per la memorizzazione dei daii. Ogni tabella di 
un database ha un nome univoco e contiene campi che descrivono le single voci 
dei dati della tabella. Quindi, per esempio, poneste dar vita a ima tabella chiamala 
Automobili che potrebbe memorizzare i seguenti dati relativi a un'auto: marca, mo- 
dello e colore. Poiché volete creare tre campi di dati, immettete automobili nel 
Campo Nome e 3 nel campo Campi, quindi fate clic sul pulsante Esegui. PHPMyAd- 
min visualizzerà l'editor di tabelle della Figura 34.9. 
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Figura J4.a 

Creazione di un database. 
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Figura 34.9 

Modifica dei campi della tabella. 

appropriala dei campi. La Figura 34.10 illustra il modulo completato appena prima 
della creazione dei campi della tabella facendo clic sul pulsante Salva. Una volta ul- 
timalo, il database dovrebbe essere come quello della Figura 34.11, 
nella quale potete vedere che il database mio_database ora ha una singola tabella 
automobili costituita da tre campi di dati. 

Accesso rapido a un database 

Una volla completato, un database è accessibile dal menu a discesa sulla sinislra 
dello schermo- Quando create un nuovo database, quest'ultimo verrà aggiunto a 
questo menu in modo da consentire un accesso rapido. 



Eliminazione di database e tabelle 



Una volta selezionato un database, è possibile modificare le tabelle che lo costitui- 
scono- È anche possibile eliminare completamente una tabella. A tal fine seleziona- 
te il database dall'elenco a discesa sulla sinistra della schermala di PHPMyAdmin; 
dovete fare clic sul nome del database sulla sinistra della schermata sotto l'elenco a 
discesa, Verranno visualizzate le tabelle disponibili nel database, come illustrato 
nella Figura 34 1 2, Potete eliminare qualunque tabella del database Facendo clic sul- 
la casella accanici al nome della tabella e sdezionandu HHmilKt dal menu a discesa 
Se selezionati. Infine l'aie die su Bsoruì per togliere la (sballa dui database, 
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Figura 34. 10 

Campi della tabella completati. 
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Il database "mio_daub..sa" con Ut UJotU 
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Figura 34. 12 

Eliminazione di tabelle o di interi database. 



Backup del server o dei database MySQL 

È sempre consigliabile effettuare un backup regolare dei propri database. PHFMy- 
Admin fornisce un metodo molto efficiente per eseguire questa operazione. Per pri- 
ma rosa selezionate il database di cui effettuare il backup dal menu a discesa sulla 
sinistra della schermata. Poi, una volta visualizzala la struttura delle tabelle del data- 
base, selezionate la scheda Esporta nella pane superiore della finestra. Dovreste ve- 
dere la schermata della Figura 34.13- 

Per creare un backup del database, accertatevi che tutte le tabelle siano selezionate 
nella finestra Esporta, poi fate clic sull'opzione Salva con nome e immettete il nome 
del file nel campo del modulo. Quando fate clic sul pulsante Esegui, la struttura del 
database e i dati contenuti verranno salvali con il nome di file che avete inserito. 

Eliminazione di un database 

Con PHPMyAdmin è possibile eliminare un intero database. A tal fine selezionate il 
database da eliminare dal menu a discesa, poi fate clic sulla scheda Elimina nella 
parte superiore della finestra, come mostrato nella Figura 34.14. Apparirà una fine- 
stra che chiede di confermare l'eliminazione del database, 
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Figura34.l3 

Creazione di un dump per "mio_database" (backup). 
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Figura 34.14 

Eliminaaonc di un datatale. 



Riepilogo 



Questo capitolo lui introdotto il gestore di database MySQL, indicando dove ù pus 
Slbilé procurarselo e spiegando come installarlo. È sialo anche descritto lo strumen- 
to PHPMyAdmin, che funge da interfaccia utente grafica per II database MySQL 
permette di creare e modificare i database. Nel prossimo capitolo vedrete un po' 
più da vicino come aggiungere dati veri e propri alle tabelle del database con lo 
s ini merito PH PMyAdmin. 



Capitolo 35 

reazione di database 



con 




min 



Introduzione 

In quesiti capitolo verni tentato l'impiego dello strumento PHPMyAdmin per creare 
un semplice database costituito da tre tabelle. Quindi si mostrerà come popolare 
queste tabelle con record di dati. 



Creazione del database 

verri! creato un database di nome amicl&autamabiU. Dalla schermata principale di 
PHPMyAdmin, digitate nel campo apposito il nome di questo database e fate clic 
sul pulsante Civa. 

Il database dovrà essere composto da tre faldelle separate, il progetto del database ò 
quello della Figura 35.1. 
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Figura 35.1 

Campi e struttura delle tabelle del database amiciSautomobili. 



Croate unii tabella denominata automobili e inseritevi quadra campi, come mostra- 
lo nella Figura 35.2. 
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Figura 35.2 

Creazione della tabella automobili e valori dei campi. 



Il campo idAutomobilc è di tipo int, è la chiave primaria ed è impostato con l'attri- 
buto extra auto_increment. In altre parole, ogni volta die si crea un nuovo re- 
cord, MySQL genera automaticamente il valore per il campo. 

Un volta latto clic sul pulsante Suina per mernoriKiare questa tabella, apparirò la 
schermata della Figura 35-3- Sotto il nome del database, nella parte sinistra della 
schermata, compare il nome della tabella automobili. 

Fate clic sul nome del database amict&automobiH nel menu a discesa che appare 
nella parte sinistra della schermata e, nei campi modulo visualizzati, create la tabella 
successiva, denominata amici, composta da tre campi. La Figura 35.4 mostra la ta- 
bella completala prima di fare clic sul pulsante Salva. 

Dopo aver salvato la tabella, sotto il nome del database amici&attlomoMi, nella 
parte sinistra della finesira, dovrebbero comparire in elenco entrambe le tabelle: 
tuiloniobiii e amici. Infine, ripetete la medesima procedura per creare l'ultima ta- 
bella del database, proprietà, costituita da due campi. La Figura 35.5 mostra la tabel- 
la completata prima di fare clic sui pulsante Salai. 

Ora, avete completato la struttura del tlatabase e siete pronti per cominciare ad ag- 
giungervi record di dati. 
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Figura 35.3 

il database amiciSautomobili con la tabella automobili. 
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Figura 3S.4 

Il database amici&.TiftoaioW» con k UtM*« «yiMi 
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Figura J5.5 

Il database airìià&automobili con la «bella proprietà. 



Aggiunta di dati al database 

Per aggiungere i record dei dati alle tabelle del database- potete utilizzare PHFMy 
Admin. A tal line è sufficiente fare clic sul nome della tabella cui volete aggiungere 
un record (provate ad aggiungere un record alla tabella automobili), 
f nomi delle tabelle sono elencati sono il nome del database, nella parte sinistra del- 
la schermata, Fate clic sulla scheda Inserisci, nella parte superiore della schermata; 
comparirà la schermata di inserimento righe, mostrata nella Figura 35.6, dove SOM 
stati inseriti alcuni dali del record: siete pronti per fare clic sul pulsante Esegui in 
modo da inserire i dali nella tabella. 

Ricordate di non inserire dati nel campo idAutomobile, che verrà creato automatica- 
mente. 

Inserite nella tabella uuinmobiii i dati della Tabella 35. 1, 



Tabella 35.1 


Dati della tabella automobili 
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Colare 


Ford 


Focus 


Blu 


Ford 
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MPV 


Nero 


Renault 


Clio 
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Argento 
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Flgura 35.6 

Inserirrtento di una riga nella tabella automobili. 



È possibile visualizzare i dati inseriti nella tabella facendo clic sulFicona alla sinistra 
del nome; della lalx'lla elencato solKi il 11. une del database, nella parte- sintetea della 
schermata. Facendo clic su questa icona, nella finestra verranno visuali^ati j record 
dei dati contenuti nella tabella, come mostrato nella Figura 35,7, 
Aggiungete i dali delle Tabelle 35.2 e 35-3 rispettivamente alle tabelle del database 
umici e proprietà. 

La Figura 35.8 mastra i dati delia Tabella 35.2 inseriti nel database. 



Tabella 35.2 Dati della tabella amici 
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Garibaldi 
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Figura 3S.7 

Dati della labella automobili, 
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Figura 3S.8 

Dati della iabcm.vn<i, 



La Kigura 35-9 mostra i dati della Tabella 33 3 inseriti nel database, 
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Figura 35,9 

Dati della tabella proprietà. 




Tabella 35.3 Dati della tabella pi-opnetà 



idAmico 

1 
1 



ìdAutomobile 



2 



3 
3 

5 



La tal^ellii proprietà consente di specificare se un amico possiede piti eli un'automo- 
bile, per esempi» gii amici con i numeri 1 e 4. Analogamente, potete specificare se 
una determinata automobile può essere posseduta da più amici; per esempio, l'au- 
tomobile 3 appartiene a tre persone diverse, 



Modifica e cancellazione dei dati 



Se durame l'aggiunta dei record al databa.se vi atv< irgeic ili .iv«»r commesso un emi- 
ro e dovete apportare una correzione, non. preoccupatevi, Quando volete cancella- 
re un record, fate semplicemente clic sull'icona accanto al nome della tabella per vi- 
sualizzare la tabella con i record dei dati. Accanto a ogni record ci sono i pulsanti 
Modifica ed Elimina (rispettivamente, le icone con il loglio e la penna e il cestino). 
Con un clic sol pulsante I£ìimina, compare una finèstra <:he chiede di confermare la 
cancellazione. 

Questa finestra è mostrata nella Figura 35.10. 
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Con un clic sul pulsante Modifica, comparirà una finestra dì modific a c ome quella 
della Figura 35.11. 
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Figura 35. li 

Modifica di dati. 



Riepilogo 

Questo capitolo ha dimostrato come utilizzare PHPMySQL per popolare un databa- 
se con i dati e come manipolare questi ultimi. Tuttavia, le reali potenzialità del data- 
base MySQL si manifestano appieno solo quando si utilizza PHP per accedere ai da- 
ti. Il prossimo capitolo metterà in luce le itali capacità di MySQL c ollesando serici 
PHP al database MySQL. ^' * 1 



Capitolo 36 

Accesso a MySQL 
tramite PHP 



Introduzione 

I capitoli precedenti hanno descritto come creare database, dar vita a strutture di ta- 
belle al loro interno e inserire record di dati nei campi. Benché tutto ciò sia utile, 
non mette in luce la reale potenza dei database. In questo capitolo si vedrà come 
sia possibile impiegare PHP per accedere, visualizzare e modificare record di data- 
base tramile ima pagina Web. Questa tecnologia e alla base di gran parte delle ap- 
plicazioni Web dinamiche, in particolare i sistemi di e-commerce. 



Connessione a un database 

Per connettere uno script PHP a un database MySQL, è necessario introdurre quat- 
tro funzioni, la prima delle quali è mysql_connect( }. che instaura una connessio- 
ne dallo script alla posizione di un database specifico. 
La sintassi della funzione è la seguente. 

resource mysql_connect [string server, string nomeutente, string password) ; 
La tabella seguente descrive gli argomenti e il tipo di valore restituito dalia funzione. 



Nome 


Tipo 


Descrizione 


server 
nomautente 
password 
Restituzione di 
mysql_connect( ) 


string 
string 
string 
rasDurce 


Notale del server. 
Nome ulenie. 
Password. 

Un identificatore di risorsa che punta al ser- 
ver. 



La funzione mysql_connoct ( ) restituisce un tipo resource. Questo tipo di varia- 
bile è slato nominato per la prima volta nel Capitolo 6, Questo identificatore di ri- 
sorsa risulta necessari"! in c|n.inUi d ura in avanti sarà utilizzato in tutte le funzioni 
correlate al database. 

La feconda funaioli* <• xiya<|l_«*Uet_dl}( ), Che consente di specificare quale da- 
tabase nella posizione d< lum i im-IIi Imi/ione my(jql_connecti ) desiderate utiliz- 
zare. « 



Li sintassi della liiivjoih- è la seguente. 

bool mysql_select_dlj(string nomedatabase resourco identificatore) ; 



La tabella seguente descrive gli argomenti e if tipo di valore restituito dalla funzione 



Nome 


Tipo 


Descrizione 


nomedatabase 


strina 


Nome del database. 


identificatore 


resource 


L'identificatore di risorsa restituito dalLi 






funzione mysql_connect( }. 


Itesiitiizkjne di 


boolean 


Restituisce TRUE in caso di sucotf-'W«.i. 


mysql_select_db() 




FALSE in insù contrario, 



Quindi è necessario nominare la funzione die( J , che è un alias di exit ( ) . Di que- 
ste funzione si è già parlato brevemente nel Capitolo 24; La funzione die() viene 
combinata con un operatore OR per interrompere l'esecuzione dello script nel casti 
in cui non sia stato possibile stabilire la connessione al database precedente. Infine, 
la funzione mysql_error( ) restituisce il testo del messàggio di errore dell'opera- 
zione MYSQL precedente. 
La sintassi della funzione è la seguente. 

string mysql_error() 



La tabella seguente descrive il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


Resiituìione di mysql_error( ) 


string 


Messaggio di errore. 



It frammento che segue offre un esempio di come queste funzioni vengano utilizza- 
te insieme: 



$tìb = mysql.ccMtnectriocalhQst", "root\ 'stobbie") or die{ "Impossibile 

connettersi: " . mysql_error{ ) ) ; 
mysql_select_do { "f riends&car-s " , Sdb ) ; 

Osservate che in questo esempio di mysql_connect ( ) l'host specificalo è "lo- 
calhost*; tuttavia, se il server MySQL non si trovasse sulla stessa macchina sulla 
quale avviene lo sviluppo del sito, questo avrebbe l'indirizzo Web di quel compu- 
ter. Il secondo parametro è il nome niente, in questo caso "root". Il nome utente 
dev'essere specificato se il database è stato creato con limitazione di sicurezza. L'ul- 
timo parametro è la password selezionata per il proprio nome utente. 
La (unzione inysql_select_db ( ) seleziona il database amici&mttomobili osato 
nel capitolo precedente. 

Per agevolarne l'utilizzo sani creato uno script MySQL esempio36-rib-php nel quale 
viene effettuala la connessione al database. 

<?php 

//Accesso a MySQL • Esempio 36 -db 

// • 



Sdb = mysqi_connect("localhosf , "root", "stobbie") or die( "Impossibile 

connetterai: " . mysql_error( ) } ; 
my$ql_select_db( 'amici&autonjobili" ,$db) ; 

?> 

Questo file verrà incluso in tutti gli esempi di questo capitolo, 

fc» v 

Selezione dei dati 

La funzione mysql_query ( ) viene impiegata per selezionare dati da un database 
con una query SQL (Sfructiitvd Query l&ngttagé), 
La sintassi della funzione è la seguente. 

resource mysql_query [string query, resource identificatore); 

La tabella seguente descrive gli argomenti e il tipo di valore restituì» dalla funzione, 

Nome Tipo Descrizione 

Query string Query SQL. 

identificatore resourcs L'identificatore di risorsa restituito dalla fun- 
zione mysql_conriect{ ). 
Restituzione di resource Identificatore di risorsa per i record restimiti. 
ysql_query< ) 

i 

Esempio di funzione: 

Sresult = inysql_query{"SELECT * FftOM users" ,$db) ; 

Lina volta ottenuto un insieme di risultati, e necessaria una funzione che restituisca 
il contenuto di una cella di record dall'insieme dei record. Questa funzione prende 
il nome di mysql_result ( ). 
La sintassi della funzione è la seguente. 

■ixed mysql_result (resource risultato, int riga, mixad campo); 



La tabella seguente descrive gli argomenti e il tipo di valore restituito dalla funzione- 



Nome 


Tipo 


Descrizione 




risultato 


resource 


L'identificatore di risorsa restituito 


dalla fun- 






zinne mysql_result(). 




identificatore 


int 


Numero di cella da restituire, dove 


0 è la pri- 






ma cella. 


campo 


mìxed 


Il nome del campo da restituire. 




Restituzione di 


mixed 


Cella del campo del database. 




my3ql_query() 







Esempio di funzione: 



*rec= Biysql_roBUli(ir«iult,l, *cogoom<r - ) ; 



SI comincerà con la creazione di ano script dir i-.ii.m- mi -.ingoio record dalla tabel- 
la amici dei database amici&aulomobili. CoasidLT.Hi- lo script PHP seguente: 

<?php 

//Accesso a MySQL - Esempio 36-1 

H" - ..... ! 

require ( "esempia36-db .php" ] ; 
7> 

<btml> 
<bOdy> 

<?php 

Sresult = dlysql_query("SELECT * FROM amici' ,$db) ; 

echo 'nome: ". mysql_result (Sresult.Q, "nome" J . "<br />"; 

echo "cognome: ". mysql_result($result ,0, ■cognome" ) . "<br />*: 

?> 

</botìy> 
<html> 

Questo esempio visualizza il contenuto della prima riga (riga 0) del campo dei re- 
cord del database. Ovviamente non si muta ancora di un esempio molto utile, in 
quanto viene visualizzato un .solo record. Verrà creato ora un nuovo esempio che 
include un ciclo in grado di visualizzare tutti i record del database. A tal fine è ne- 
cessario introdurre una nuova funzione di iìdme myscjl_f etch_row{ ). j 
La sintassi della funzione è la seguente, 

array mysql_fetch_row(resourca risultato); 

Là tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome 


Tipo 


Descrizione 


risultato 


resource 


t.'klcruifi«iiore di risorsa, restituito dalla fun- 
zinne mysql_result ( | , 


Restituzione di 
mysql_fetch_row() 


array 


Arr.iv dei record del database interrogato. 


Esempio di funzione: 







ìneoordS = mysql_fetcfw-ow{$resuH:) ; 



Dato che la funzione restituisce un array dei canili per il record, l'accesso a dUestì 
avviene con l'indicizzazione dcll'array. Per esempio, la seguente istruzione restitui- 
sce il secondo campo di un record. 

Srecords[l]; 



Lo script che segue illustra una versione modificata dell'esempio precedente, che 
visualizzerà tutti i record presenti nel database. 



t?php 



//Accesso a MySQL 



Esempio 36-2 



equire ( "esempio36-db. php" ) ; 



?> 

<html> 
<bady* 

<?php 



Sresult = mysql_query("SELECT * FROM amici" ,$db) ; 

while ($records = raysql_fetch_row(Sresult)} { 
echo "nome; '. Srecords[2] . "<br />'; 
echo "cognome: Srecords[1] . "<br />"; 

> 



</body> 



<html>° V> 

Questo script e simile all'esempio precedente, però introduce un'istruzione di ciclo: 



whila ($rec = mysql_fetcli_row(Sresult) ) { } 



Osservate die nel ciclo si trova una nuova funzione, mysql f etch_row( ), che re- 
stituisce un singolo record, memorizzato nella variabile Sresult.ìl record viene 
poi memorizzato in un array di nome Srec. Le istruzioni echo visualizzano ciascun 
elemento dell'array $rec[ ], che contiene il valore di ogni campo dei record. 1,'ele- 
mento [01 dell'array contiene l'ID del record, mentre [1] contiene il nome degli amici 
e [2] il loro cognome. Ciascuna iterazione del ciclo while determinerà la chiamata 
della funzione mysql_fetch_row( }, che ogni volta restituirà il record successivo 
del database. Quando non trova piti record, restituisce FALSE e il ciclo viene termi- 
nato. 

L'output di questo script è quello della Figura 36.1. 

Nell'esempio precedente veniva utilizzata la funzione mysql_f etch_row( ) per ac- 
cedere ai record del database e visualizzarli. Benché questa soluzione funzioni, il 
programmatore che scrive Io script deve fare riferimento ai campi separati tramile 
gli indici dell'ai ray, il che non agevola la lettura elei codice e lo espone all'introdu- 
zione di errori. Li funzione mysqljf etch_array() è una versione estesa di 
ntysql_f etch_row() . 
Li sintassi della funzione e la seguente. 



array mysql_f otch_arroy<rtiQurot risultato); 
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nome; Alessandro 
cognome: Manzoni 
nome: Dante 
cognome: ALjJuen 
nome; Giuseppe 
cognome: Garibaldi 
nome: Giacomo 

cognome: Leopardi 



Figura 36.1 

Record del database. 





Lii tabella seguente descrive l'argomento e il tipo di valore restituito dalla Funzione, 



Nome Tipo Descrizione 



risultato resource L'identificatore di risorsa restituito dalla funzione 

fliysql_result(), 

Restituzione eli array Array dei record del database chiamino in causa, 
mysql_fetch_arrayO 

Esempio di funzione: 

Srecords = mysql_f etch_array(Sresult) ; 

r -I 

Questa funzione è uguale a mysql_f etch_row( ), tranne per il fatto che consente 
di fare riferimento ai campi del database utilizzandone 11 nome. Lo script che segue 
illustra l'utilizzo di questa funzione. 

<?php 

I /Accesso a MySQL - Esempio 36-3 
// 



require resempio36-db.php") ; 
?> 

. . » • I 

<html> 

<body> 
<?php 



Sresult - mysql_-query{ "SELECT 4 FROM amici", Sdb); 

while ($records ■ raysql_f etrch_array(SrBsult}) \ 
e elio "nomo; ". Srecords [ 'nome' | . "<br />"; 
ocho " cognome: '. Srecords [ "cognome' | . *<br />"; 



Tecniche avanzate di selezione dei dati 

Le istruzioni delle queiy SQL che vengono inviate al database con la funzione 
mysql_query ( ) sono in grado di eseguire operazioni mollo più complesse rispetto 
agli esempi illustrati finora in questo capitolo. Occorre soffermarsi .sull'analisi di al- 
cune caraneristiche che possono essere di aiuto per selezionare i dati richiesti dal 
database. 

Selezione di un certo numero di record 

Le query SQL possono utilizzare l'opzione LI MIT per selezionare un certo numero 
di record da una tabella. L'opzione LIMIT richiede due parametri: il primo (>y rap- 
presenta la riga di partenza, mentre il secondo (y) rappresenta il numero di record 
che devono essere selezionati a partire da x. Per esempio: 

$query ■ mysql_query | "SELECT campi FROM tabella LIMIT 1,3", $db) ; 

Questo esempio seleziona 3 record a partire dalla riga 1. Lo script che segue illustra 
quanto appena affannato. 

<?php 

//Accesso a UySQL - Esempio 36-4 
^y. ......................... ...... 

require Cesflmpiose-db.php") ; 
?> 

<html> 
<body> 

<?php 

$result - mysql_query { "SELECT * FROM amici LIMIT 1,3", Sdb); 

while (srecords = mysql_fetcli_array (sresult )} { 
echo "none: ". Srscordsf 1 nome 1 ] . "<br />"; 
echo "cognome: ". Srecords [ 'cognome' ] . "<;br />"; 

) 

t> 

</body> 

<ntmi> 



> 

</body> 
<html* 



L'output di questo script è uku.i!.- .i i|iir||u mici precedente, tranne per il l'aito che 
vengono visuali/vati solo In- m i mi 



Ordinamento dei record 

Le query SQL possono impiegare l'opzione ORDER BY per ordinare i dati selezionali 
L'opzione ORDER BY dev'essere seguita dal nome della colonna (campo) e da 
un'opzione aggiuntiva che definisce se l'ordinamento dev'essere crescente fase) □ 
decrescente (desc); 

Squery ■ mysql_query ('SELEGT field(s) FHOU table ORDER BY cognome desc", Sdb); 
Lo script che segue mostra i risultati ordinati in ordine crescente di cognome; 
<7php 



//Accesso a MySQL ■ Esempio 36-5 

II--- — 

require (■esempiD36-db.pr1p , ); 
?> 



<htnu> 
<body> 

<?pnp 



Sresult = mysql_query("SELECT * FROM amici ORDER BY cognome asc'\Sdb); 

' " V '''' • '• ' 

while ($records = mysql_fetch_array ( Sresult ) ) { 

eciio "nome: * . Srecordsf nome 1 ] . "<br />"; 

echo "cognome: ". Srecordsl "cognome' ] . "<br />"; 

} 



1> 

</body> 
<html> 



L'output di questo script è quello della Figura 36.2. 
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Figura 36.2 



umc, 




Inserimento di dati 



Finora avete visto come estrarre dati da un database, tuttavia sarebbe utile anche 
poterne aggiungere di nuovi. La funzione mysql_query ( ) utilizzata con la query 
INSERT INTO è la soluzione a quesiti problema: 

Sinsert = mysqLqueryC INSERT INTO tabella (colonnal , colonna2 

colonna- x) VALUES (' valore', 1 valore \ .... ' valore ')" ,$db); 

Con una query INSERT INTO, i nomi dei campi della tabella (ossia delle colonn 
devono essere specificati nello stesso ordine dei valori di questi ultimi. Non c'è al- 
cuna restrizione al numera di colonne utilizzabili per l'inserimento di dati, tuttavia si 
siglia di specificare tutte le colonne in una query INSERT INTO indicando valori 
joti per (incile che desiderate lasciare vuote. 
Potete comunque evitare di utilizzare le colonne e ricorrere a una struttura alternati- 
va per la query' di inserimento, come nell'esempio che segue. Osservate che il pri- 
mo valore verrà inserito nella prima colonna, il secondo nella seconda e cosi via. 

Sinsert = mysql_query( J INSERT INTO ranella VALUES ("valore' , 'valore', 
-", 'valore')" ,$db); 

L'esempio che segue utilizai la query INSERT per aggiungere un nuovo record alla 
■ la*»"'". 

tip 



^Accesso a MySQL ■ Esempio 36-6 
// 



require ('esempio36-db.php") ; 

IL 



<html> 
<body> 

<?php 



Sresult = fflysql_query("SELECT * FROM amici ORDER BY cognome asc", Sdo); 

while (Sracords = mysql_f etch_array (Sresult > ) { 
echo "Id: ". Srecords[ ' idAmico' J . '<br />'; 
echo "nome: ". Srecordsl" nome ' J , "<br />"; 
echo "cognome: *, Srecordsj ' cognome 1 ) . "<br /><br />"; 

} , ;' ,. 

?> 



</body> 



L'output di questo script è quello della Figura 36,3 e niowni il record appena ag- 
giunto. 
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14 2 

nome: Dante 
cognome: Alighieri 

Idi 

nome: Ugo 
cognome: Foscolo 

14 6 

nome: Ugo 
cognome: Foscolo 

14 3 

nome: Giuseppe 
cognome: Garibaldi 

144 

nome: Giacomo 
cognome: Leopaidi 

14 1 

nome: Alessandro 
cognome: Manzoni 



Inserirne/ita di record 





Eliminazione di dati 

È possibile eliminare record dalle tabelle utilizzando la funzione mysql_query( ) 
con la querv DELETE FROM: 

$DELETE - mysql_query ( "DELETE FROM tabella WHERE coloniia= 1 $valore 1 " , 
Sdb); 

L'esempio che segue illustra uno script che consentiri di eliminare qualunque re- 
cord sia Stàio inserico nel database a patto di immetterne il numero di 1D. 

<?php 

//Accesso a MySQL ■ Esempio 36-7 

// 



require ( , osBinpio36-db.php") j 
7> 

<html> 
<body> 
<?php 

if (isset($_POST[ 'id'])) { 

Sdelete = mysql_query(" delete from amici where 
idAmico^$_POST| idi * ,$db) ; 
echo c<tir>fiecord eliminato<br>") ; 

) 



Sresult = mysql_query("SELECT * FROM amici" ,$db) ; 



while ($records = mysql_fetch_array ($result) ) { 
echo "Id: ". Srecords[ 1 idAmico" ] . "<br />"; 
echo "nome; ", Srecords['nome'] . "<br />"; 
echo "cognome: '. $records[ 'cognome'] . - <br /><br />'; 

} 



<form action="<?php echo S_SERVER[ 1 PHP_S6LF' ] ?>* fiiethod="poat"> 



7> 



Id; <input type="texf name="id , xbr> 
«input type= "submit" value=" Elimina record ■> 

</form> 
</body> 
<ntml> 

L'output di questo script è quello della Figura 36-4, dove il record con id 5 è appena 
stato eliminato, 

Questo script contiene un'istruzione if che verifica il valore di Sid, il quale indica 
se il modulo è stato inviato. $id viene utilizata per selezionare il record da 
eliminare: 

if (isset(S_POST[ "id' ])) { 
Se la variabile $id contiene un valore, la funzione mysql queryf ) viene chiamata: 

$delete = mysql_query C DELETE FROM amici WHERE 

idAmiCO=S_PQST[id] " : Sdb) ; 

eotio ("<br>Record eliminatotbr»" ) ; 

> 

Questa funzione elimina il record nel database che ha un id pari a Sid. Osservate 
che questo script non contiene alcuna forma di controllo di errore, quindi l'utente e 
libero di digitare un numerò di id qualunque. 
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Record eliminalo 
lèi 
come: 



.Alessandro 



cognome: Manzoni 
142 

nome Dante 
cognomi" Alighieri 

143 

nome: Giuseppe 
cognome; Garibaldi 

144 

nome- Giacomo 
cognome: Leopardi 



record 



il 



gj0p«u&uf» empietele 



Figura 36.4 

Il record con id 5 è stato eliminato. 



Aggiornamento dei dati 

la funzione mysql_query ( ) può essere utilizzata per consentire l'aggiornamento di 
un record esistente. Ciò avviene con il ricorso alla query UPDATE, 

Succiate = myaql_query ( "UPDATE tabella SET colonna1=' valore" , 
colonna2=' valore' ... colonnaX= ' valore ' WHERE colonna= ' valore '" ,$db) ; 

Lo script che segue utilizza un modulo per aggiornare i record esistenti. Per garanti- 
re che venga modificato il record corretto, si ricorre al suo id. 

<?php 

//Accesso a MySQL - Esempio 36-8 



require ( 'esempioae-db.php" ) ; 



<html> 
<body> 
<?php 

if <i$set($_POST['id'])) < 

Sresult = mysql_query( 'UPDATE amici 
SET cognome^ '$_POST[ cognome! 1 , 
nome=' S_POST{nome] 1 
WHERE i(IArnico='$_POST[idl'" 1 $db); 

> 

Sresult ■ mysql_query( "SELECT * FROM amici", Sdb) j 

while {Srecords ° mysql_fetcti_array($result) ) { 
ecno "Id: ", Srecords [' idAmico" ] . "<br />'; 
ecno "nome: ". Srecords [ 'nome" | . "<br />'; 
eclio "cognome: ". $records[' cognome"] . "<;br /xtjr 



?> 

<forra action="<?php echo $_server| ■phpjself' ] ?>• method='posf> 

Id: <irput type="text" name="id"><br l> 
Nome; <input type^texf name~"nonie"><br /» 
Cognome; <input type^text" name="cognome"><br /> 
<input type="submit" value= "Aggiorna record "> 



</form> 
</body» 
<html> 



Conteggio delle righe e verifica 
dell'esistenza dei record 

La funzione mysql_num_rows( ) può essere utilizzata per contare il numero dei re- 
cord in una tabella e verificare se un record esiste. 
La sintassi della funzione è la seguente. 

int mysql_nun_roMJE(resoijrce risultato); 

La tabella seguente descrive l'argomento e il tipo di valore restituito dalla funzione. 



Nome Tipo Descrizione 



risul tato rosource L'idt'ntificatore dì risorsa resiituiK- tliìllu funzione 

mysql_result(). 
Resiituzione di int Numero eli righe di record, 

mysql^num^rowai ) 



Esemplo di funzione! 

Srecords = raysql_num_raws (Sresult) ; 

Considerate l'esempio che segue, dove la funzione mysql_num_rows t ) viene utiliz- 
zata per contare i record (le righe) correnti della tabella amici. 

<?php 

//Accesso a MySQL ■ Esanpio 36-9 
il 

r-equire (■esen)pio36-du.php"); 
?> 

<html> 
<body> 

<?php 

sresult = nysql_query("SELECT - from amici", Sdb) ; 

«rows = niyscil_niiin_rows($result); 

if($rows) { 

echo 'Trovati $rows recard"; 

y i ' ••' ■'.'•rf'p-C " 

else { 

echo "Nessun record trovato"; 

J 



*/oady> 
<html> 

Questo script visualizzerà il messaggio Trovati 4 record". 



Riepilogo 



Questo capitolo ha mostrato come sia possibile utilizzare uno script PHP per estra.r* 
re dati da un database MySQL. Inoltre si è visto che PI IP e anche in grado di elìmj- 
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Capitolo 37 

Classi e oggetti 




Introduzione 



Molti linguaggi di programmazione moderni supponano il paradigma dell'orienta- 
mento agli oggetti. Si tratta semplicemente di un modo alternativo di progettare e 
implementare i programmi. Nell'ambito del paradigma orientato agli oggetti, t pro- 
grammatori modellano elementi noti come classi e li utilizzano all'interno di un pro- 
gramma creando istanze di queste classi, note con il nome di "oggetti" 1 . PHP suppor- 
ta la creazione di classi e l'implementazione di oggetti e permette al programmatore 
di sviluppare programmi orientati agli oggetti Questo capitolo spiegherà il concetto 
dell'orientamento agli oggetti e fornirà qualche esempio degli dementi di tale para- 



L orientamento agli oggetti è un paradigma che incoraggia e aiuta a riutilizzare il codi- 
ce. Inoltre tende a ridurre al minimo l'impatto di qualsiasi modifica di programmazio- 
ne, grazie a una tecnica nt*a eoa il nome di "incapsulamento" L'orientamento agli 
Oggetti è un modo diverso di concepire la soluzioni' a un problema di programmazio- 
ne. Le tecniche di programmazione strutturata tradizionali risolvono i problemi scom- 
ponendo la soluzione in funzioni facili da programmare. Queste funzioni vengono 
raggruppate all'interno del programma per eseguire le operazioni necessarie (Figura 
371). Si tratta della tecnica adottata per risolvere i problemi emersi in questo libro. 
Anche se nel corso degli anni questa tecnica si è rilevata molto utile, essa non aiuta 
I programmatori a riutilizzare in modo efficace il codice e non contribuisce nemme- 
no a proteggere i dati da modifiche accidentali. Con un approccio funzionale, i dati 
locali possono essere dichiarati all'interno di una funzione, tuttavia potrebbero es- 
sere richiesti come parametro per un'altra funzione per consentire un'ulteriore ela- 
boraziniic V' le siiuiinn li il. ili passate da una funzione all'altra sono grandi e 
complesse, può .u > .uW-n ■ In- si veril'k Inno errori di programmazione che possono 
allena- i dati 

La programm.i/n me .< • -kk-h |»>fUi un approccio diverso alla progettazione dei 

dati. In un progetto a oggetti, l ilai p~.Ii 'noi: .in. he come luti/inni) vengono 
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Che cosa sono le classi e gli oggetti 








visuattiraj»™» 
dal modulo 



Convalida 

dal modulo 



Visualizzazione 
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37.1 

Progetto di program m azione funzionale. 



mento. Solo i metodi associali alla classe sono in grado di accedere- ai dati e alterar- 
li, creando una sorta di •'interfaccia" con i dati stessi- 
Questa parti* rotore invocazione dei metodi di una classe è nota come invio di un 



messaggio alto. 
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i37.2 



L'evienia mento agli oggetti incoraggia il riutilizzo del software, in quanto consente al 
programmatore di definire nuove classi simili a quelle già ea totcffll ; Il programmatore 
è quindi in grado di affermare; "Questa classe è identica a quell'altra, eccetto che per 
qualche piccala differenza". Il grande vantaggio è che il programminole deve solo in- 
dicare le differenze, poiché tutto il codice già scritto per la classe originale diventa au- 
tomaticamente accessibile alto nuova classe, Questa caratteristica è nota con il nome 
di "ereditarietà". L'orientamento agli oggetti supporta anche il polimorfismo, il concet- 
to secondo cui alcune classi correlate hanno tutte un metodo con lo stesso nome. 
Per esempio, potreste aver creato alcune classi clic disegnano forme diverse sul moni- 
tor. Tutte le forme hanno un metodo, chiamato draw( ) . che consente loro di visualiz- 
zare se stesse sullo .schermo. Il programmatore può richiamare il metodo draw(} in 
una qualsiasi di queste classi sapendo che sullo schermo compatirà una torma. Tutta- 
via l'immagine risultante cambierà in base alla classe cui viene inviato il messaggio. 
Il lavoro non termina con la creazione delle classi. In realtà, infatti, le classi sono 
modelli che definiscono quali dati è possibile contenere e come gli stessi possano 
essere utilizzati. In pratica, le classi sono una versione sofisticata delle variabili. Le 
variabili sono progettate per contenere dati di un tipo specifico e con esse si posso- 
no eseguire determinate operazioni. Tuttavia, prima di poter utilizzare una variabile 
è necessario crearne un'istanza. Lo stesso vale per le classi. La classe è un modello e 
per utilizzarla è necessario creare un'istanza della classe che contenga dati. L'istanza 
di una classe prende il nome di "oggetto ". 

Classi e oggetti in PHP 

Anche se la maggior pane dei linguaggi di programmazione a oggetti implementa le 
funzionalità descritte in precedenza, ciò non vale per lutti i linguaggi. Infatti, in base 
al linguaggio di programmazione utilizzato, la terminologia cambia. Per esempio, i 
tennini "metodi di classe", "funzioni" e "procedure" descrivono tutti la medesima 
cosa. Analogamente, "membri di ctotT e "variabili di classe" sono espressioni che 
fanno riferimento al medesimo conceno. 

PHP mantiene una terminologia semplice e coerente con gli altri aspetti del linguag- 
gio Nella definizione di una classe, il programmatore specifica le variabili e le funzioni 
incluse nella classe stessa. Non saranno utilizzati nomi nuovi per questi elementi poi- 
ché ciò provocherebbe confusione. Le istanze delle classi sono indicate come oggetti. 
Proverete ora a creare una semplice classe per capire come sia facile lavorare con esse. 

Creazione di una semplice classe 

La parola chiave utilizzata per definire una classe è class A ogni classe dev'essere 
assegnato un nome univoco e occorre utilizzare le parentesi graffe { } per indicare 
l'inizio e la fine della definizione di una classe. Per esempio, per creare una classe 
denominata veicolo utilizzerete la sintassi seguente: 

<?pnp 

class veicolo ( 
I 



All'intoni, i tifili- classi e possibile incapsulare v .in.il .il. 1. ». «rubili ili classe ymn 
ètflliW COttC le «fera sanabili PHP; Tunica differenza riguarda la parola chiave var, 
che deve precedere la variabile stessa. Per esemplo: 

var Sdescription; 

Le friabili di classe devono essere inserite all'interno della definizione di classe, tra 
le parentesi graffe iniziale e finale. Per esempio: 

<?pr>p 

class veicolo { 
var Sdescription; 

) 

?> 

Alle classi e anche possibile associare funzioni, che offrono un'interfaccia per i dati 
della classe. Tutte le funzioni contenute nella classe possono accedere a tutte le va- 
riabili della classe Ogni funzione eli classe viene definita esaltamente come qualun- 
que altra normale funzione estema. Per esempio: 

function display!) i 

Le funzioni di classe possono essere create in modo da ricevere parametri e/o resti- 
tuire un valore. Per esempio: 

function aet(Sd) { 
} 

Anche le funzioni devono essere racchiuse tra le parentesi graffe iniziale e finali 
della classe: 

«?php 

class veicolo { 
var Sdescription; 

function set ($d| { 

} 

function display () { 
1 

1 

?> 

Per il momento, queste funzioni non eseguono alcuna operazione, poiché non con- 
tengono codice. In questo caso si vuole che la funzione set( ) assegni la variabile Sd 
i > ita come parametro alla variabile di classe Sdescription Om-su opera/min 
implementa una funzione die permette di impostare il valore di Sdescription 
quando m i ii- .« un oggetto della classe, Prokil .limonio siale |*!i-.ariii.' i he I istru/i. me 



tdtscripuon • M; 



MPtflnl il valore Sd a Sdescription Non è così Dato che Sdescription è una 
v .inabile di < lasso e non \ iene dw Inarata o passata alla ftllHÉnfl set) >..- MMÉM 
una sintassi speciale per fare riferimento a Sdescription A tal fine verrà utilizzata 
b variabile Sthis. che significa "questa classe", e l'operatore -> seguito dal nome 
della variabile. Per esempio: 

Sthis ->description 

Osservale che non è stato inserito un simbolo $ prima del nome della variabile. Per 
assegnare una variabile $d a questa variabile utilizzerete l'istruzione: 

this sdescription = Sd; 

Per quanto riguarda la funzione display ( ) , si vuole che visualizzi il valore dì $de ■ 
script ìon. A tal fine, utilizzerete l'istruzione: 

flcfio($ttus->dascripUon) ; 

La classe che segue include queste funzioni complete. 
<7php 

class veicolo f 

var Sdescription; 

function 96t($d) { 

Sthis >description * $d; 

j 

function displayO { 

ech0($thts>description); 

y 

?> 

Ora, disponete di una classe che contiene una variabile e due l'unzioni che con- 
sentono di impostare e visualizzare il valore della variabile. Se provaste a visualiz- 
zare l'output dello script precedente in un browser rimarreste alquanto delusi, 
poiché non comparirebbe alcunché. Infatti, è stata creata una classe in modo cor- 
retto, ma non è stala ancora utilizzata. Ora dovete creare un istanza di questa clas- 
se, ossia un oggetto. 

Utilizzo della classe veicolo 

Per utilizzare la classe veicolo, dovete creare un oggetto (una variabile, se preferi- 
te) di questa classe A lai fine è necessario utilizzare la parola chiave new con la sin- 
tassi seguente: 

%Nom»Ooo*tto- nw no—CI*»Mt. 



Penatilo. |M-t creare mi uggi-ito di nome $vei che .■ un isianz» della classe veico- 
lo, dovrete scrivere. 

$vei = new veicolo; 

c:iò in pratica equivale a dichiarare una variabile $vei, però non avete ancora asse- 
gnato alcun valore. La classe è Maia progettata per contenere un solo dato nella va- 
riabile Sdescription Non potete scrivere* semplicemente: 

•description = "Un'automobile blu ; 

poiché non potete assegnare valori alle? classi, ma solo agli oggetti. Allora forse è 
possibile scrivere: 

$vei ><jeseriptian = "Un'automobile blu'; 

In questo modo cercate di assegnare un valore a una variabile specifica, apparte 
nente a un oggetto che avete crealo, tuttavia una delle regole" alla base della pn > 
grammazione .1 oggetti i- l'incapsulamento. Il concetto di incapsulamento prevede 
l'occultamento dei dati ali intemo di un oggetto e non permette di visualizzarli o 
modificarli In che modo potete assegnare un valore a questa variabile? Attraverso li- 
funzioni di classe che avrete creato in precedenza. 

Per assegnare un valore agli oggetti occorre invocare la funzione set(). che è 
stata progettala per ricevere un paramelro e memorizzarlo nella variabile di 
classe $description. Per richiamare la funzione di un oggetto si ricorre all a 
sintassi seguente: 

$No<»eOggetta->nomeFumioi}0l ) 

Penante, per invocare la funzione set< ) dì un oggetto Svei passandole i dati "La 
mia automobile nuova fiammante. ", dovrete scrivere: 

Svei >5etCLa mia automobile nuova fiammante.'); 

Questa istruzione passa la stringa "La mia automobile nuova fiammante. ' alla 
funzione set( }. che appartiene agli oggetti vei. la funzione memorizza la stringa 
nella variabile di classe Sdescription. Per visualizzare il valore memorizzato nella 
stringa, è necessario invocare la funzione display ( ) come mostrato di seguilo: 

$vei >display( ) ; 

Questa istruzione va letta tosi: chiama la funzione display!) dell'oggetto Svei. 
io script che segue aggiunge quesle istruzioni al vostro script, che contiene la 
classe veicolo; 

<?php 

// Classi - Esempio 37-1 

li - 

class veicolo { 
var $de$cription; 

functlon Mt(Sd) ( 

Ithls ►aascrlption • So; 

} 



fune t ion display ( ) { 

echo($thls->description) ; 

ì 

ì 

$vei ■ new veicolo; 

Svei >set("La mia automobile nuova fiammante."); 
Svei >displayO; 

?> 

Loulpui olle-nulo da questo script è quello della Figura 37.3- Non molto interessan- 
te, ma e solo l'inizio! 




Figura 37.3 

Output ottenuto da una dasse. 



Invocazione delle funzioni di classe 
dall'interno di una classe 

Le funzioni di classe possono essere richiamate dall'interno di 
necessaria è la seguente: 

$th is->norneFum ione ( ) ; 

Questa funzionalità è mollo uiite poiché permette di invocare le funzioni automati- 
camente. Considerate l'esempio che segue, che è una variazione di quello prece- 
dente. Come potele vedere, la funzione Set ( ) contiene al suo interno una chiamata 
alla funzione displayf > ; ciò consente di \ isualizzarc automaticamente il valore di 
description quando si invoca la funzione 5et( ). eliminando la net essila di invo- 
care la funzione display( ) al di fuori delloggetto. 

<?php 



Il Classi 

// 



Esvnpio J7 9 
class veicolo ( 



vèr Sdescrtpt lon ; 



function aet{$d) ( 

$this->description ■ $d; 
Sthis->display() ; 

} 

function display/.) { 

echo<$this->description); 

J 

Svei = new veicolo; 

$vai->set{"La mia automobile nuova fiammante."); 
?> 

L'output Ottenuto da questo script è uguale a quelli) della Figura 37.3. 



Creazione di più oggetti di una classe 

Una volta creata una classe, potete creare tutti gli oggetti che desiderate. È proprio 
come avere tutte le variabili stringa necessarie ali interno ili uno script. Le stringhe 
sono tutte variabili diverse, ma tutte dello stesso tipo. Lo script seguente illustra tre 
oggetti chiamati Sautomobile. Sbicicletta e Saereo, tutti del tipo veicolo- 

<?php 

// Classi ■ Esempio 37 3 

// 

class veicolo { 

var Sdescription; 

function set(Sd) { 

$tnis->description - $d; 
$this->display(); 

function display! ) { 
echo(Sthis>descriptlon . -<br>"); 

ì 

Sautomobile = new veicola; 
Sautomobile ->set ( "Auto sportiva" ) ; 
Sbicicletta = new veicolo; 
Sbicicletta ->set{ "Mountain bike" ) ; 
Saereo - new veicolo; 
Saereo- »set ( "Biplano" ) ; 

7> 



l.out,nii pi- Illuda questo script èquello della Figura 37,4. 



1-I»hp Murowirì ini i-i tiri I h|ì 1 1 . i 



Fto ModFica Vnuéea Prefw* -n rmi ■ 




Auto sportiva 
Mountain bike 
Bipiano 



Figura 31.4 

Più oggetti delto stesso tipo. 



Costruttori 




Vi sarete sicuramente accorti che la creazione di un oggetto è un processo in due 
fasi. Per prima cosa si crea un oggetto nuovo, quindi si chiama una funzione che 
popola tale oggetto con i dati. Fer esempio: 



Sautomobile = new veicolo; 
SautonK5bile->setCAuto sportiva"} ; 



Esiste un metodo per eseguire queste due operazione in un passaggio unico. A tal 
fine è necessario creare un costruttore, ossia una funzione che viene chiamata auto- 
maticamente quando si crea un nuovo oggetto. Una funzione diventa costruttore 
quando ha lo stesso nome della classe. Per esempio, una funzioni" costruttore per la 
classe veicolo avrebbe l'aspetto seguente: 



function veicolo! SdJ { 
Sthis ->description 
Strtis- 

) 



Sd; 



Il costruttore assegna il valore della variabile $d alla variabile $description, poi ri- 
chiama la funzione display ( ). Con un costruttore a disposizione, potete associare 
la . reazione dell oggetto e la popolazione dei dati con la sintassi seguente: 

Sautomobile» new veicolo) "Auto sportiva"); 

Questa sintassi crea un nuovo oggetto di nome Sautomobile della classe veicolo, 
e passa la stringa "Auto sportiva" alla funzione costruttore. Lo script completo è 
quello che segue. 



<7php 

Il Classi 

//• 



E»«i*plO 37-4 



class vaicelo ( 

Vir tdwription, 







function valcolo(Sd) { 
Stria ->description 
Sthi5>display( 

> 

function display () { 

echo($this>descriptlon 

> 




"<Dr>"); 



Sautomobile = ne* veicolo) 'Auto sportiva'); 
«bicicletta = ne* veicolo) "Mountain bike') ; 
Saeroo = new veicolo< -Biplano"}; 

?> 

L'output ottenuto da questo script è uguale a quello della Figura 37.4. 



Array di oggetti 




Gli oggetti creali possono essere trattati come le variabili, pertanto è del timo 
bile creare un array 

<?php 

// Classi ■ Esemplo 37-6 
// 

class veicolo { 

ver tdescr-iptian; 

function veicolo ($d) { 

Sthis->description = $d; 
Stlus >display(); 

ì 



I 



function display^ { 

ect>o($this->dtscription 

1 



«automobile = new veicolo) "Auto sportiva"); 
Sbicicletta = new veicolo) "Mountain bike"); 
Saereo = new veicolo! "Biplano" ) ; 
Sarray = arraytSautoisobilejSblcicietta^aereo) ; 
foreach($array as SilVeicolo) 
echo) SilVeicolo >displayO) ; 

?> 

Questo script mostra t he i tre oggetti veicolo rreati possono essere inseriti in un 
array (chiamato Sarray) e che a essi si può accedere con un ciclo f oreach L'out- 
put prcxli .la questo script è quello della Figura V S 



OmsI e oggetti «79 





Anto sportiva 
Mountain bike 
Biplano 

Auto sportiva 

Mountain bike 

...ali 



Figura 37.5 

Utilizzo e* oggetti m un array. 



Funzioni e oggetti 



Gli oggetti possono essere passati alle l'unzioni come avviene con le variabili. I 
script che segue mostra un problema cui occorre prestare attenzione. 



<?php 
// Classi 

f f . m . . ............. 

class veicolo { 
var Sdescription; 

function veicolo) $d| { 
$this->description ■ $d; 
$thi S ->displayO; 

} 

function set (Sdì { 

$this->description = $d; 
$this->display(); 

} 

function display () { 

echo[$tnis->description . "<br>")| 



1 



function change(Sv«i){ 

Svei->«at{"Auto «portivi rosta*); 

} 

Sautomobile • m veicolo! "Auto •portiva"»; 

chanae(SiutonoblU); 

Sautonroblle -Jl.pl*,) U 



L-apttoio a 



Lo * npl contieni- unii classe veicolo modific .ila I air modifica riguarcLi l'aggiunta 
della funzione set(). che consente di cambiare la dev i morte di-I veicolo dopo 
aver creato un nuovo oggetto. È stata inclusa anche una funzione non di classe, de- 
nominata change(). 

Tale funzione riceve un oggetto veicolo come parametro e quindi invoca la fun 
itone dell'oggetto set(). 

Lo script crea l'oggetto Sautomobile, richiama la funzione change( ) e le passa i'og 
getto Sautomobile. Infine invoca la funzione display! I di Sautomobile Dato che 
la funzione change( ) altera la descrizione, potreste aspettarvi di vedere l'output Au 
to sportiva" (quando viene creato l'oggetto ». "Anto sportiva rossa" quando la destri 
/ione vime mollificala dilla lun/ione change{) e infine \uto sportiva tossa" quan- 
do la funzione display ( ) viene chiamata al termine della funzione. L'output effettivo 
è quello della Figura 37.6 e come vedete corrisponde alle vostre aspettative, almeno 
fino ali ukim , chiamala alla funzione deU'oggetto display ( | 




tocathoM fhKihook eitrmxo j /-fa ph«i - Miocnoft Interne* Eaptotei 



VKdttt Vtsuab» ci oferia Sa ,r lenti ? 



Auto sportiva 
Auto sportiva rossa 
Amo i 





Figura 37.4 

Output ottenuto dall'esempio d> funzione. 



L'oggetto sembra tornato alla sua descrizione originale. F. accaduto, infatti, che alla 
funzione changet ) è stata inviata una copia dell'oggetto, ed è questa a essere stata 
modificata. Se volete che la funzione alteri l'originale, dovrete modificare la chiama- 
ta alla funzione nel modo seguente: 

change(&Sautomobile); 

La chiamala per riferimento è stata spiegata nel Capitolo 13. 



Over load delle funzioni 
e argomenti predefiniti 

Le funzioni di classe, al pari delle loro corrispondenti non di classe, possono inclu- 
dere valori come argomenti predefiniti, In tal modo una funzione può essere ehia- 
mata con o senza argomenti, se si sa con cene/za die il valore predefinito mancan- 
te sarà impostato. La funzione costruttore dello script che segue mostra quanto ap- 
pena illrrmato impostando la descrizione del veicolo ■ 'Costruttore ignoto". Le 
tlissi n. >n mi|,|u.ìi.i,io hncload delle lim/ioni I overUwd e il concetto secondo 
cui una daMt; può contenere più lun/i.-m I- a. s. II.. •.. npi . he m 



gue noterete che è stato necessario implementare due funzioni seti) e 
dove una riceve un parametro e l'altra no. Nel caso della seconda funzione, 
ili description è impostiti) a 'Funzione set ignota'. 



<?php 



setu(), 
il valore 



// classi 

li 



esempio 37-7 



class veicolo { 

vai- $description; 

function veicolo(Sd=" Costruttore ignoto') { 
$this-»description = Sd; 
Sttiis-displayO; 



} 



function 59T{$d) { 

$this>description = Sd; 
$this>display(); 

1 

function S9tu{J { 

$this->description = 'Funzione set ignota'; 
Sthis ->display( J; 

1 



function display!) { 

echo(Sthis->aescriptlon 

} 



■<br>'); 



Sautomobile = ne* veicolo) 'Auto sportiva*); 
«automobile^ = new veicolo(); 
$auto«iobile2 >setu() ; 



?> 



L'output prodotto da questo script e quello della Figura 37.7. 



"JliltM ■ lo. alimi!. p4*i»ok.r»riiipto:i7-'.oh(J - M«ro»oO Intontì txptwcr 



n* HnMlu vuuaaai Ptefenu «rumeno ? 




Auto sporti»» 
Costruttore igpoio 
Furinone set ignota 




Figura J7.7 

Output de* overtoAd 0 



Creazione di una classe più complessa 



Finora avete visto esempi di classi molto semplici per capire le funzionalità a oggetti 
supportate da PHP. L'esempio seguente illustra una classe leggermente più com- 
plessa e qualche iterazione ira gli oggetti. Verrà creata una classe di nome j uq che 
permette di modellare la funzionalità di una caraffa. Ogni oggetti) jug può contene- 
re una cena quantità di liquido. 

Ma l'esempio non finisce qui. Saranno create due caraffe e ognuna di esse potrà 
versare una pane 0 tutto il proprio contenuto nell'altra. 

<?php 

lì Classi - Esempio 37-3 

// 

class jug { 
var SmaxVol; 
var ScurrentVol; 
var Snane; 

function jug(Sn,$m,Sc) < 
Sthis >name = $n; 
5this>maxVol « 5m; 
Sthis. >currentvol = $c; 
Sthis >display(); 

> 

function addLiquid($vH 

Sthis >currentVol ■ Sthis ->curr«ntVol * Sv; 

) 

function rame(H 

return Sthis • >name ; 

ì 

function isThereLiquidl Svol ) { 
lf ($this->currentVol >= Svol) 
return 1; 

else 

return 0; 

} 

function isThereSpace(Svol) { 

if( (Sthis >maxVol - Sthis ->currentval) >- SvolJ 

return t| 
else 

return »; 

} 

function dlsplay() { 

echo('<br»" . $this->name . " ha un volume massimo di " . 

$thl«-MUixVol . * e attualmente contiene ' , Sthis - >currentvol ) ; 

) 



function pourlnTo(totherJug,Svol) { 



echo("<br>versamento di Svol unità da " . Sthis ->name( ) ' in " . 

SotherJug->na*ie()); 
if (Sthis >iSTher8Uiquid($vol)) { 

if (SotherJug->isThereSpace(Svol) ) { 
SotherJug>addLlquid{Svol) ; 
Sthis ->currentVol = Sthis >currentVol Svol; 
$this>tìisplay(>; 
$otherJug-»display(); 

> 

else { 

echo( "<br>Tentativo fallito - Spazio insufficiente."); 
return 0; 

ì 

} 

else \ 

echo(-<br*Tentativo fallito - Liquido insufficiente,*); 
return e; 

ì 

return 1; 
} 

I 

SmyJug - new jug ("Caraffa 1' ,100,50); 
SanotherJug = ne* jug( 'Caraffa 2', 50, 25); 
SmyJug ->pourInTo(S.$anotherJug , 10) ; 
Sanotherjug >pourlnTo(SSrayJug,34) ; 

1> 

10 script inizia creando una classe di nome jug. La classe e costituita da tre variabili 
che servono per memorizzare il volume massimo di liquido che la caraffa può con- 
tenere, la quantità correrne di liquido nella caraffa e il nome della caraffa (che serve 
solo a identificarla): 

<?php 

class jug { 
var SmaxVol; 
var Scurrentvol; 
var Sname; 

11 costruttore crea l'oggetto con le tre variabili che riceve e invoca la funzione di ■ 
splay ( ) pa visualizzare lo stato della caraffa 

function jug($n,$m,$c) { 
Sthis >nama ■ Sn; 
Sthis >maxvol ■ $■; 
Sthis ->corr»ntVol ■ Se; 
SthlB >dtsplay|); 

\ 

La funzione addLiquld' ) conacniu di Aggiungere altm liquido alla caraffa. La fun- 
zione namei ) uMiiui- . i della tarami 



function addi iqu id( |v)t 

«thii »eurrenlV«l ■ limi »eurr»niVol ■ •«; 



1 



function name(){ 

return Sthis ->name; 

) 

La funzione- isThereLiquidf ) verifica se il liquido contenuto nella caraffa è ugna- 
le o supera il valori' del volume passalo alla funziono in Svol. Se ce liquido a suffi- 
cienza, viene restituito il valore 1, altrimenti 0: 

function isThereLiquid(Svol) f 
if (Sthis ->currentVol >= $vol) 

return 1 ; 
else 

return 0; 

} 

La funzione isThereSpacef ) verifica se nella caraffa c'è spazio sufficiente per il 
volume di liquido passato alla funzione in Svol In caso affermativo, viene restituito 
il valore 1, altrimenti 0: 

function isThereSpace(Svol) { 

if( (Sthis >maxVol ■ Sthis -xurrentVol) >= Svol) 

return 1; 
else 

return 0; 

La funzione display ( ) visualizza la quantità di liquido che la caraffa e in grad 
contenere e la quantità attualmente contenuta: 

function display!) { 

ecno(-<br>' . $thi6->naaie . • ha un volume massimo di ■ . 
^ Sthis ->maxVol . - e attualmente contiene 1 . Sthis ->currentVol) ; 

La funzione P ourInTo{ ) è la più complessa ira quelle incontrate finora, e penante 
nclucde di essere suddiv isa in sezioni più piccole Per prima cosa, la funzione ac- 
cetta due argomenti, SotherJug e $vol. 

Uno rappresenta l'oggetto j ug in cui sarà riversato il liquido e l altro il numero di 
unità da versare: 

function pourlnTo (SotherJug, Svol) f 

Successivamente, la funzione usuali/.™ il numero di unilà che saranno versale da 
questa caraffa nell'altra. Con una chiamata alla funzione $OtherJuo->namef ) si ot- 
tiene il nome dell'altra caraffa: 

echoC<br>Versamento di $vol unità da 1 . $this->naroe< ) . ■ in ■ 
SotherJug >nameO>; 

Quindi, una chiamala alla funzione isThereLiquidf ) accerta se la caraffa contie- 
ne liquido .i sitili, u hai da versare nell'altra c.u.ilt.i 



ifISthi» >ltTh«raUquid|$vol>) ( 



Uassi 6 oggetti 485 



Se il liquido è sufficiente, la funzione isThereSpace( ) di otherjua viene invc 
per verificare se l'altra caraffa può accettare il liquido, In caso affermativo, la funzio- 
ne addLiquid() di otherJug è richiamata per aggiungere il liquido e il volume 
corrente di liquido in questa caraffa diminuisce. Infine, compaiono i contenuti delle 
due caraffe: 

if ( SotherJug ■ >isThereSpace ( Svol ) ) { 
5otherJug->addLiquid(Svol); 

$thiS->CurremVol - Sthis ->current Voi • Svol; 
Sthis >display(); 
Sotherjug >dlsplay{); 

> 

Se non c e spazio sufficiente, viene generato un messaggio d'errore: 
else { 

echor «orientativo fallito - Spazio insufficiente.'); 
return 0; 

} 



Se il liquido non basta, viene generato un messaggio d'errore: 
else ( 

echoC<br>Tentativo fallito - Liquido insufficiente. ■ | ; 
return 0; 

ì 

} 

Sono state creale due caraffe: la prima, Caraffa 1 , ha un volume massimo di 100 uni- 
tà ed è piena a metà. Caraffa 2 ha una capacità massima di 50 unità ed e anch'essa 
piena a metà: 



SmyJug = new jug( "Caraffa t", 180,50); 
SanotherJug > new jug( "Caraffa 2" ,50,25); 



Viene invocata la funzione pourInTo( ) dell'oggetto myJug e le vengono passati i 
valori SanotherJug e 10. In questo modo. myJug cercherà di versare 10 unità in 
anotherJug: 

SmyJug- >pourIriTo(&$anotherJug, 10) ; 

Infine, viene invescata la funz.ione pourlnTo() dell'oggetto anotherJug e le ven- 
gono passati i valori SmyJug e 34. In questo modo, anotherJug cercherà di versare 
54 unità in myJug: 

SanotherJug >pourInTo<MmyJug,34) ; 

?> 



L'output prodotto ila ijiiesi.. si npi e <|iu II. ■ della | : igur.i V\K. 
la Figura f H illustra la irraruiiK- di ciiirarnhe k caraffe e le interazioni tra 
Dopo i In- di i .. ili • I . M in. v. i-mi., un \*< di liquido m i .naif a J e \ i< eversa, il 
volume ili liquido n« II. ,1ue . arali. . ambialo vi,. Vi e a le 7 . 



.1 I l.u.llll,.«l i !,.!,. 1 . .„, i 'I i, I | mi A-„, , 



H. Hodhra •tou*aa Piatali «unii ì 



«lflt.Hl 



Caraffa 1 ha un volume- massimo 4 100 ? attualmente contiene 50 

C«rafia 2 ha un volume massai» di 50 e iltuilmente contiene 25 

Versamento é 10 uniti da C «raffi 1 in Caraffa 2 

Cinto 1 ha un volume mutano è 100 e attualmente contiene 40 

Canto 2 ha un volume massime' 4 50 e attualmente contiene 35 

Versamento di 54 uniti da Caraffa 2 m Caraffa 1 

Caraffa. 2 ha un voliere mas s uri o A ~U r an\ialiTn"!r.ti* coiìticiic l 

Carato 1 ha un volume massimo cb 100 e attualmente conuene 74 



figura 37.8 

Output dell'oggetto jug 



Oggetti all'interno delle classi 

Si è già visto come gli aggetti possano invocare le proprie funzioni e quelle degli al- 
ni ..ggclti 

Non sapete ancora, però, che si possono creare oggetti che contengono altri ogget- 
ti. In qualche caso questi oggetti sono indicati con il nome di oggetti compositi 
Nell'esempio sarà creata una classe denominata serratura e una classe composita 
di nome porta che conterrà una serratura- Potete creare oggetti di tipo serratura 
separati (e sarebbe opportuno che lo faceste), ina quando create una porta non po- 
tete fare a meno di creare anche una serratura. 

Iniziate con la classe serratura (che contiene un'unica variabile per memorizzare 
se la serratura è chiusa oppure no), un costruttore per configurare la serratura e una 
funzione display! ) per visualizzare lo stato della serratura: 

<?php 

// Classi Esempio 37-9 



class serratura { 
var SlockUnlockj 

function serratura{$lu) { 
$this->lockUnlock = $lu; 

} 

function display!) { 

ecrtoC<br>Li serratura è • . Sthls->lockunlock) ; 

) 

) 



la classe porta è un po' più complessa (ma non mollo.). Contiene due variabili: la 
prima, SopenClosed, serve per memorizzare se la porta è chiusa o aperta: la secon- 
da, S serratura. mcmnri//a l'oggetti* serratura che andrete a creare: 

class porta ^ 

var SopenClosed; 
var Sserratura; 

Il costruttore riceve due parametri. Il primo, Soc, serve per impostare il valore della 
variabile SopenClosed II secondo, Slu, viene passato al costruttore della classe 
serratura quando create l'oggetto serratura: 

function porta($oc ,$lu}{ 
$this->openClosed - $oc; 
$thls- serratura = new serratura ($lu) ; 
$thla->display(); 

> 

Quando alla variabile Sserratura, che si trova all'interno della classe porta, viene 
assegnato un valore, si tratta effettivamente di un 'istanza di un nuovo oggetto serra- 
tura. La funzione display () visualizza il valore della variabile SopenClosed all'in- 
terno della classe- porta. Quindi, invoca la funzione display dell'oggetto serratura 
Cile appartiene alla classi: serratura. Questa chiamata richiede due operatori ■>: 

function display {)( 

echo("<trr>La porta è 1 . $thls->openClosed) ; 
Sthis serratura >display<); 

I 



L'output ottenuto da questo script è quello della Figura 37.9. 
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La porta t chiusa 
La serratura è aperta 



Figur. 31.9 

Output di oggetti ali interno A «fin Ofjrtt. 
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Questo capitolo ha introdotto il concello di orientamento agli ometti, spiegando la 
differenza tra classi e ometti e mostrando come utilizzarli in PHP 
Avete imparato a creare qualche semplice classe e avete visto come vengono co- 
struite le variabili e le funzioni di cbs.se. Inoltre, avete appreso il concetto di incap- 
sulamento e visto come le interazioni tra variabili deNxtno avvenire attraverso le 
(unzioni di ciasse. Infine, avete appreso il concetto di oggetto composito. Tuttavia, 
[ argomento della programmazione a oggetti non è esaurito. L'orientamento agli og- 
getti fornisce infatti una funzionalità chiave per il riutilizza del software. Questa fun- 
zionalità è nota con il nome di ereditarietà e sarà l'argomento del prossimo capitolo 



Capitolo 38 

Ereditarietà delle classi 




■ 



Introduzione 

Nel capitolo precedente sono stali introdotti i concetti di orientamento agli oggetti, 
classi e oggetti. Si è visto come PI IP possa essere impiegalo per creare classi e come 
sia possibile usare le istanze di queste classi per creare oggetti, All'inizio del capito- 
lo precedente si è visto come uno dei vantaggi dell'orientamento agli oggetti sui il 
suo supporto al riulilizzo del codice. In questo senso, la caratteristica principale 
dell'orientamento agli oggetti è l'ereditarietà delle classi, Questo capitolo introdurrà 
l'ereditarietà delle classi, illustrando in che modo e perché si riveli utile Verrà intro- 
dotto anche il concetto di polimorfismo, che è correlato ali ereditarietà. 

Che cos'è l'ereditarietà delle classi 

Uno dei punti di l'orza dell orientamento agli oggetti è la capacità di ereditare pro- 
prietà da altre classi già esistenti. Ciò comporta un risparmio di tempo per il pro- 
grammatore, riduce la complessità della soluzione e aiuta a migliorare la qualità ri 
ducendo la duplicazione del codice, e pertanto l'introduzione di errori. Il program- 
matore è in grado di accedere a tulle le variabili e funzioni della classe dalla quale 
vengono ereditale e di aggiungere variabili e funzioni alla nuova clas.se. I ti esem- 
pio di ereditarietà è illustrato nella Figura 5H.1. Nell'esempio sono presenti due clas- 
si, strumèntoOiScrittura e matita; la freccia da matita a strumentoDiScrit- 
tura indica che matita eredita da quest'ultima. 

La freccia può essere letta come "è uri, pertanto il diagramma illustra t he una ma- 
tita "è uno" strumentoDiScrittura. La freccia indica inoltre che tutte le variabili 
e le funzioni della classe StrumentoDiScrittura sono disponibili per la classe 
matita Vedrete ora come implementare questa relazione in PHP. 

Parola chiave extends 

La paiola . In.ivi atlanti* iimr iuilizz.ua per indicare che una classe eredita da 
un'altra la smlav-i .• U M guviilo. 
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Figura 38.1 

Ereditarietà. 



Per implementare le due classi della Figura 38.1 ottone scrivere quanto segue: 

class strumentoDiScrittura { 
} 



class matita extends StrumentoDiScrittura ( 
f 



Ovviamente questi sono solo i modelli delle classi senza alcuna variabile o funzio- 
ne. Occorre fornire un contenuto alle classi e quindi, per esempio, la classe stru- 
mentoDiScrittura potrebbe essere implementata nel modo seguente: 

class strumentoDiScrittura { 
var $textColour; 

function strumentoDiScrittura! $t) { 
$this->textColour = St; 

} 



> 



function display! > { 
BCho("il colore è 

} 



. $tnis->textColour . ■ , <br->'); 



La classe StrumentoDiScrittura contiene una singola variabile StextColour, 
che verrà utilizzala per memorizzare il colore del lesto prodotto dallo strumento 
di scrittura La classe contiene inoltre un costruttore per creare il colore del testo 
dell'oggetto e una funzione display< ) per visualizza» il valore del colore del 
lesto. 



dr.i siete pronti per implementare la classe matita Inizialmente la manierale il 
più semplice possibile: 



class matita extends strumentoDiScrittura { 

function matita ($t> { 

$this>strumBntoDiScrittura{$t|; 



La clas.se matita è molto semplice: non contiene variabili propr i e e la sua unica 
funzione è un costruttore. Konnalmente, le classi che ereditano da altre classi han- 
no bisogno di un costruttore poiché, nel caso in cui venga creata un istanza della 
classe, è necessario poter costruire il valore delle variabili nella classe ereditata. In 
questo esempio il costruttore della classe richiama semplicemente il costruttore del- 
la classe StrumentoDiScrittura, passandole il valore del colore della mina della 
matita Osservale che il costruttore della classe StrumentoDiScrittura viene chia- 
mato come se fosse un membro della classe matita con la sintassi seguente: 

mU >strum*ntoOiScrittura (« ) ; 

Questo avviene perché tutte le funzioni, compreso il costruttore della classe eredita- 
ta, fanno parte della classe matita. 

Osservando meglio la classe matita potete notare che la classe di per sé costituisce 
un'ereditarietà piuttosto inutile, in quanto la classe matita non fa niente di diverso 
dalla classe StrumentoDiScrittura. ri quindi necessario estendere la funzionalità 
della classe matita così che operi diversamente dalla classe StrumentoDiScrit- 
tura e pertanto diventi utile. 

Aggiunta di nuove funzioni e variabili 

Nel paragrafo precedente è stata creata una classe matita che eredita dalla classe 
strumentoDiScrittura. Sfortunatamente la classe matita non includeva alcuna 
variabile o funzione propria che la rendesse diversa dalla classe ereditata. È quindi 
il momento di intervenire: 

class matita extends strumentoDiScrittura { 
var Ssttarp; 

function matita ($t,$s) { 
$this->sharp - $s; 
$thìs-»struiiiflntoDiscriuiJra($t); 
*thiB>di8play2()i 

1 

function dlaplay2() { 

echo('«br>La matita * ■ . Sthis - >sharp . " e ■); 
Sthi»->diiplay(); 

1 



< >u |,i , I.ism' mrt t ita | M una . .uul.iU- Mhurp ! Ii<- verrà utilizzala |x-i memorizzare 
se la matita ha la punta a t •puntata II eiWruiinre . -.tato nimlih. at.. per creare la 



variabili - Ssharp r per richiamare la classe 5trumentoDl8crÌttUTa. dove verrà 
costruito il colore del tesici. Infine, è stala inclusa un.i tun/u uh- display? ( ) per vi 
sualizzare il valore della variabile Ssharp e per invocare la funzione display ( ) di 
strumentoDiScrittura, 

Ora è possibile creare oggetti di tipo strumentoDiScrittura e matita: 

Sthing = ne* strumentoDiScrittura» "blu - } ; 
Sthing >display( ) ; 

SmyGreyPencil ■ new matita! "arigio" , "appuntita" ) ; 

Il listato completo è il seguente: 

<?php 

// Ereditarietà delle classi ■ Esempio 3B- 1 

tff-t» 

class struraentoOiScnttura { 
var StaxtColour; 

function strumentoDiScrittura [$t) { 

function display () { 

echoril colore è k . $this >tBxtColour . "<br>'); 

} 

ì 

class matita extends strumentoDiScrittura { 
var Ssharp; 

function matita! St, Ss) ! 
Sthis ->sharp = Ss; 
Sthis - StrumentoDiScrittura! $t ) ; 
Sthis-'displaySO; 

function display?!) ( 

echo("<br>La matita è ■ . Sthis ->sharp . • e *); 
Sthis->display() ; 

J 

$thino = new strumentoDiScrittura! "blu" ) ; 
$tninfii->display(); 

SmyGreyPencil = new matita! "grigio" , "appuntita" ) ; 
?> 

La combinazione di queste istruzioni in uno script pnxlurra l'output della Figura 38.2. 
La Figura 38.2 mostra che l'output è diverso per i due oggetti. Tramite l'ereditarietà 
siete riusciti a creare una nuova classe matita, che riutilizza parte del codice della 
classe StrumantoDiScrittura Facendo questo non avete alterino in alcun modo 
la classe struiwntoDlScrittura e avete «ito Mabiht. . r ,h vino le differenze ira 
le due iI.inm 
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,11.2 

Output ottenuto con l'ereditanetà. 



Ulteriore estensione dell'ereditarietà 

Una volta creata una struttura di ereditarietà, potete continuare a estenderla a vosiru 
piacimento. La Figura 38.3 mostra una classe aggiuntiva di nome penna, che eredita 
anch'essa cb strumentoDiScrittura Volendo potreste aggiungere una classe che 
eredita dalla classe matita. |kt esempio una classe chiamala Supermatita sempre 
appuntita, che avrebbe quindi ereditato nitri gli attributi della classe matita e quelli 
di StrumentoDiScrittura; per il momento, però» la classe panna è sufficiente. 




Figur» J8.3 

Edenaiorwddl-WHfttanitt 



Lo script c lic segue sv iluppa l'implementazione della (inora Vi ■« Ir c lassi s 
mentoDiScrittura e- matita rimangono invariate, ma or» c'e una nuova 
dilaniala penna « li. loninm un costruttore e una lun/Miie displayZ() 



// Ereditarietà delle classi Esempio 38 -2 

H 

class strumentoDiScrittura { 
var StextColour; 

function strumentoDiScrittura! $t) { 
$tnis->textColour = St; 

) 

function display!) { 

echo("ii colore è 1 . $this->textColour . "<br>"|; 

) 



class matita extends strumentoDiScrittura { 
«ar $sharp; 

function matita ($t, $a) { 
$this->sharp = ss; 
Sthis- StrumentoDiScrittura! St ) ; 
$this>display2(J; 

> 

function display?)) { 

echo{'<br>La matita è 1 . Sttlis >sharp . " e ■); 
$this>display(); 

r 

ì 

class penna axtends strumentoDiScrittura { 
var SinkPresent; 

function penna |$t,$i) ( 
$this->inkPresent = $i; 
Sthis ^strumentoDiScrittura ($t I ; 
$this>display2(); 

function display3() •: 

echoC<Dr>La penna ha ■ . $this->inkPresent ."«"); 
$this >display{); 

} 

} 

$thing » new st rumentoOiScrittura ( "blu* ) ; 
Sthing- «display {); 

SaiyGreyPencil ■ ne* matita ( -grigio" , "appuntita') ; 
SwyRedPen ■ nea pannai 'roBSO* , 'inchiostro - ) 



Vengono « ostruiti e visualizzati tre oggetti e il lorti output è quello della Figura 38.4. 

-IDI x| 
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Figura 38.4 

Estensione deK'eredrtanMi 



Un esempio più complesso di ereditarietà 

Ora si esaminerà a un esempio costituito da un grande numero di classi. Considera- 
te la struttura di ereditarietà della Figura 38.5» costituita da sei classi. 
La struttura di ereditarietà della Figura 38.5 è più complessa di pnma e illustra un 
po' più chiaramente il concetto di classificazione, ossia di suddivisione delle classi. 
In fonde» alla struttura avete le biciclette, che sedo parte dell'insieme dei veicoli non 
a motore, che a loro volta sono pane dell'insieme dei veicoli. 
Ci sono poi automobili e motoscafi, che sono veicoli a motore, che a loro volta 
sono veicoli. Nell'esempio saranno prodotti solo oggetti di tipo bicicletta, au- 
tomobile e motoscafo e non del tipo veicolo. veicoloSenzaMotore e veico- 
loAMotora. Il motivo è che queste ultime classi sono state create solo per consen- 
tire di ottenere una struttura di ereditarietà, senza alcuna intenzione di avere og- 
getti di questo tipo. Fsse tuttavia erano necessarie per strutturare correttamente i 
rapporti di ereditarietà. Le classi di queste» genere spesso prendono il nome di 
"classi astratte". 

Si inizieril delincando le classi che occorrono per dar vita alla struttura della Fi- 
gura 3H.5 

*?php 



class veicolo { 
} 



class veicoloAMotora extendt veicolo { 

) 



elisa veicoloSenzaMotore extends vaie alo { 
class bicicletta estenda veicoloSenzaMotore { 

y 

class motoscafo extenas veicoloAMotore ( 
class automobile extends veicoloAMotore { 



7> 
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Figura 38.5 

Struttura di eredrurietà de veicoli. 



Questa parte di codice fornisce i modelli delle classi che andrete a creare. A questo 
punto e necessario determinare le funzioni e le variabili che ciascuna classe conter- 
rà La Figuro *>H.(i migliora la struttura della Figura 38.5 e fornisce alcuni dettagli nul- 
le variabili e le funzioni che ciascuna delle classi conterra. 

Per semplicità, ogni classe contiene un costruttore e una funzione display! ) che 
visualizza i valori delle sue variabili. Ogni classe contiene da una a tre variabili. La 
classe veicolo contiene Ire variabili per menu in /./ai e una dev/ri/ionc ilei veicolo, 
il colore e il nome del file di Immagine da visualizzare per rappresentare il veicolo. 
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Figura 38.6 

Struttura di eredrtanetà dei veicoli con metodi delle classi e dati. 

La classe veicoloSenzaMotore ha una variabile powerSource, che memorizza la 
fonte di propulsione del veicolo; vento, umana e così via. 

La classe veicoloAMotore contiene due variabili per memorizzare il tipo di carbu- 
rante (benzina, gasolio) e il valore BHP (potenza effettiva) del veicolo. La classe 
bicicletta contiene due variabili che memorizzano Li dimensione del telaio e il 
numero di rapporti. 

La classe automobile contiene una variabile che memorizza la dimensione delle 
ruote del veicolo. Infine la classe motoscafo Ita una variabile che memorizza se il 
motore è entrobordo o fuoribordo. 

Lo script seguente implementa lo schema della Figura 38.6. 
<?php 

// Ereditarietà della classi Esempio 36-3 

// 

class veicolo { 

var Sdescript Km. 
var Icolour; 
var Spie; 



Automoolle 



Dimensione ruote 



Automobile » 
Display () 



Motoac la 
Motore 



Moioscato () 
Display 0 



function veicolo(Sd,Sc,Sp) { 
Sthis >description ■ Sa; 
Stnis >colour = Se; 
Stnis ->pic = $p; 

} 

function display!) { 

echo( "<table Oorder=' 1 ■>■ ) ; 

echo<*<tr><td colspan='2><iroa src=' graphics/" . 

$this->pic . * , «/td>«/tr>'|; 
echoC<tr><td><font size=' 2 >Daacriziorie:</f ont></td> <ta><fOf>t 

size=2 >" . Sthis ->description . "</font></tdx/tr>*){ 
echo('<tr><td><font size- 2 'Colore :</font></td><td><font slze= , 2'>" 

Sthis >colour . ■</font></td></tr>* ) ; 

} 

} 

class veicoloAWotore extends veicolo { 
var SfuelType; 
var Sbhp; 

function veicolQAMotorelSft.S^Sd^C^p) { 
Sthis >fuelType = Sft; 
Sthis >bnp = $o; 
$tnis->veicolo<Sd,Sc,$p)i 

} 

function display2() { 
Sthis ^display! ) ; 

echo( "<tr>«td>«fant size= '2 ' >Tipo di 

carburante:</font></td><td><font sizt-'2'>' . Sthis >fuelType 
^/fontx/tdx/t^'); 
echo( *<tr><td><f ont aize= ' 2 >Potenza :</f ont></td» 

«to><font aize«2 >" . Sthis-»bhp . -</font></tc></tr>' | j 

} 

} 

class veicoloSenzaWotore extends veicolo i 
var SpowerSource ; 

function veicoloSenzaWotore ( Sps, Sd , $c r Sp I { 
Sthis ->powerSource = Sps; 
$this->veicolo(Sd,Sc,$p); 

function display2(> ( 
Stnis >display()i 

echo ( ■ <t r><td><f ont size= ' 2 ' propulsione : </f ont>< / tdxtdxf ont 
slze='2 , >" . Sthis ->powerSource ■ ■</fontx/tdx/tr>'); 



class bicicletta extends veicoloSenzaMotore ( 
var SframeSlie; 
ver Sgeara; 



function blciclettalSps.Sfs.Sg.Stì.Sc.Sp) { 

Sthis->frameSize ■ $fs; 

Sthis- »gears = Sg; 
^ Sthis ■ > vaicoloSenzaMotore ( $ps , $d , Se , Sp ) ; 

function flisplay3() { 
$this->display2(); 

echo("<trxtdxf 0n t size= ' 2' dimensione telaio: </fontx/td><td><f ont 
size=2>" . Sthia >fratieSize . , </font></td><i'tr>'l; 

echo ( " <trxtd><f ont size= 2 ' Rapporti :</fontx/td><td"f ant 
size=2'>* . Sthis-»gears . ■<yfontx/td></tr>" ) ; 

echo("</table>*); 

} 



) 



class motoscafo extends veicoloAWotora { 
var SengineType; 

function notoscafo|$et,Sft,Sb,Sd,Sc,Sp) { 
Sthis ->engineType = Set; 
Sthis >veicoloAMotore(Sf t , Sb , $d , Se ,Sp> ; 

} 

function display3{ ) { 
Sthis*display2( * : 
echo 



>cno(-<trxtdxfor,t size* '2 '>Uotore:</fontx/td><td><font sire='2'>* . 

Sthis >engineType '</font></td><ytr>'|; 
ecno("</tabla>'); 



} 



class automobile extends veicoloAMotora ( 
var SwhealSize; 

function automobile ($ws,Sft,J 
Sthis- >wheelSize = Sws; 
Sthis>veicoloAMotore($ft,Sb,Sd,Sc,$p); 

) 

function display ( ) { 
Sthis >display2(); 

echo{ "<tr><td><font size* ' 2 ' 'Dimensione ruote: </f ont></td><tdxf ont 

size«'2'>* . Sthis 'whaelSize . "</fontx/td></tr> - ) : 
echo("</Table>*,i 

> 

Sveh • new 

motoscafo! "Fuoribordo" , 'Diesel" ,6*), "Barca" , "Giallo' , "speedboat . jpg" > ; 
$veh2 = new bicicletta! 'Umana" , 18,21 , 'Bicicletta" , "Verde" , 'bicycle. j pa" | ; 
$veh3 - new automobile! 17, "Benzina' , 147, "Automobile Rosso" , 'car. Jpo" ) : 
Svehicle» - array (Sveh.SvoM .Svanii ; 
foreach (Svenici*» lvehicle)< 



Svenici» ->diiplay3<); 

| 

7> 

Questo script dichiara ire oggetti, un motoscafo, una bicicletta e un'automobile. 
Questi vengono copiati in un array e viene utilizzalo un ciclo f or eacri per vi- 
sualizzare ciascun oggetto invocando la funzione display3( ). Lo script utilizza 
tre immagini, che saranno visualizzate assieme ai dati del veicolo per rendere 
pid Interessante I output dello script. La Tabella 38.1 elenca queste immagini e i 
loro nomi di file. 



Tabella 38. 1 Immagini dei vftaW i 









Spccdlioftt.jpg 




Car.ipa 



L'output prodotto da questo script è quello della Figura 38.7. Osservale che il ciclo 
f oreach accede a ciascuno degli ometti dell'array e li visualizza richiamando una 
singola funzione. 

Tutto funziona bene, ma c'è un problema che dovete risolvere se volete poter sfrut- 
tare tutta la potenza dell ereditarietà. Si tratta del problema che viene analizzalo nel 
prossimo paragrafo, dedicato al polimorfsmo. 

Polimorfismo 

Avrete notato che ciascuna classe in una ramificazione della struttura di ereditarietà 
ha Ere funzioni display { ). ciascuna delle quali ha un nome diverso a ogni livello 
display! ). display2( ) e display3( ) Ciò consente di chiamare la funzione nel- 
l.i prima . I.i^- i iroliu- ncll.i Mi i unii .( 
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Figura 38.7 

Output dell'ereditarietà dei ve«:oli. 



Questo non determina alcun problema nel progetto corrente, ma cosa accadrebbe 
se voleste aggiungere una nuova classe, come mostrato nella Figura 38.8? 
La Figura 3H H segnala che ora avete una nuova classi- chiamala autoSportiva. La 
classe ha una variabile turbo che memoriz/.i la pressione in bar del mrlx noni pres- 
sore (presupponendo clic tutte Ir duo spciniw ne a libi a no uno> La classe ha una 
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Figura 3B.B 

La classe auto sportiva 



funzioni.- di vLsualiziiizioiie chiamata display4() e può 
relativa facililà. 

<?php 

// Ereditarietà delle classi - Esempio 38-4 

Il 

class veicolo { 
var Sdescri.pt ion ; 
var Scolour; 
var Spio; 



function viicolo(M,lc,»p) { 



SthU->descrlptton = *d; 
Sthis -»colour = Se; 
Sthis->pic - Sp; 

} 

function aisplayo { 

echo{"<table eorder^'i >•); 

echo("<tr><td colEpan='2"><i*Q src« "graphics/' . 

$this->plc . "'><^ta></tr>-) ; 
echo{ "«trxtdxfont size= 2 ' >Descrizio<ne:</f ont>«f td><td»f ont 

3ìzb-'2 >" . Sthisxle6criptiori . -«/fontx/tdx/tr^); 
echo{ " <tr><td><font size= ' 2 ' >Colore:</f ontx/tdxtdxf ont 

siza-'S^' . Sthis->colour . -</forit></td></tr>- ) ; 

i 

ì 

class veicoloAUotore extends veicolo \ 
var SfuelType; 
var $bhp; 

function veicoloAMotore<$ft,$b,$d,$c,$p) { 
Sthis ->fuelType = $ft; 
Sthis->bhp = $b; 
Sthis- 'veicolo (Sd,$c, Sp|; 

> 

functior display2() { 
Sthis >di3play(); 

echoC<tr><td><fOrtt size»'2'»Tipo di carburante :</fontx/td> 

<td><font size="2">" . Sthis ->fuelType . ,, «/fontx/td></tr>") ; 

echo< "<tr><td><f ont size* 2 >Potenza: « 11 ont></td><td><f ont 
siz«='Z'>" . Sthis > bri p . •</fontx/tdx/tr>') ; 

) 

ì 

class veicoloSenzaMotore extends veicolo { 
var SpowerSource; 

function veicoloSenzaMotore<Sps,Sd,Sc,Sp) { 
$this->powersource ■ $ps; 
Sthis ^veicoloiSd.Sc.Sp); 
} 

function display2() { 
Sthis ->display ( | ; 

echo ( " <tr><td><f ont size= ' 2 1 Propulsione ;</ f ont><y td><td><f ont 
si2s='2>" . Sthis -SpowerSource . "</font></ ttì></tr>* ) ; 

) 

ì 

class bicicletta «utanda veicoloSenzaMotore { 
var SfraMSize; 
var ftQtart; 

function uiciclei t«i*p».»fi.»g,»d,ic,loi ( 

fthla^f raatftire • lft| 
fthia «giara > |g; .aaBBBBBaaea— 



Sthis »veicOloSemaMotore( Sp« , Sd , $C ,$p ) | 

} 

function display3(| { 
Stnis ^displayZO- 
echot "<tr><td><f ont size='2 >DiBensione telaio:</f ontx/td><td><font 

slZ8-'2 >' . Sthis- >fra»eSize . Wfontx/tdx/tr^' ) ; 
echo( "<tr><td><f ont size= 2 1 >Rapportir<('font></td><td><font 

siTe-'2 , >' . Sthis- >aears . '</Tont></td></tr»' | ; 

} 

) 

class motoscafo extends veicoloMIotore { 
var SengineTypa; 

function motoscaf o(Set , Sf t , Sb, $d, Se , Sp) { 
Sthis >enaineType - $et; 
Sthis >veicoloAMotore($ft,$b,$d,Sc,$p); 

) 

function displaySO { 
Sthis>dispiay2() ; 

echo("<tr><td><font siza-^^Motore^/fontx/tQxtdxfont size=-2'>'. 
Sthis ->9naineType . '</fOrtt></td></tr>- i ; 

} 

} 

class automobile extends veicoloAMotore { 
var StttieelSize; 

function autOBOOiletSws.Sft.So.Sd.Sc.Sp) { 
Sthis >*heelSize * $ws; 
$this>vaicoloAMotore(Sft,Sb,Sd,Sc,$p); 

\ 

function display3() { 
$this-»display2{ J ; 

echo( '<tr><td><f ont sixe= ' 2 ' >Dimansione ruote :</f ont></td><td><f ont 
eize*'2'>" - Sthis ->wheelSize . '« If ontx/tdx/tr^ ) ; 

> 

> 

class autosportiva extends automobile { 
var Sturbo; 

function autoSportiva($t,Sws,Sft,StJ,Sd,Sc r Sp) { 
Sthls->turbo = St; 

Sthis ^automobile (Sws.Sft.Sb.Sd, Se, $p) ; 

} 

function display4() { 
Sthis ->display3(); 

echoc<tr><td><font size=' 2' Pressione turbo :</font></td><td><f ont 
9ize-'2'>* . Sthis >turbo . Wfontx/tdx/trf); 

ì 

ì 



Sv*n4 - im •utoSportiva(2,1B. "Benzina-, 239, 'Auto 
sport iva' , 'Giallo' , "SportsCar. jpg ■ ) ; 
•v«M >0i8play4{) j 
echo<"</table>'); 

?> 



Questo script i 
la Tabella 38.2. 



burniva per rappresentare l'auto sportiva dei- 



Tabella 38.2 Immagine aggiuntiva di veicolo 





SportsCar. jpg 


i 




1 



Osservale che l'istruzione echo{ "</table>" ) ; è stata riitio-ssa dal eorppo delle 
classi base della struttura e spostata dopo la chiamala della funzione display! ) 
L'output di qWflW script è qudlo della Figura 3«9. 



3 Idi,.. I. 



tuh/r-irni-pi-D^H 4.php Mbi tostili Inlrrru*! iK-ptarrv 
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Figura 38.9 

Auto sportiva 



Zi 



— 



Il problema nasce quando si voghoni n in di\eiM ocelli per t use una delle quat- 
tro classi. Iìen< he sia possibile i ri .uh « i • -Il k .uh in un arra> . quandi i m « vn .i ili vi 
Miali//arl! u»n uno. Ii-Toreach non »l «a quale (unzione display ( ) «Inamarì-, m 



<Sisplay3( ) c. tìisplay4< ), in quanto non -i con.** . ,| n,*. degli umetti contenuti 
nell'array: 

Sveh = new motoscafo! 'Fuoribordo* , "Diesai" ,60, "barca* , "Giallo" , 
'fpVfdboat.jpg'); 

$veti2 ■ naw biciclatta( "Unana* , 18,21 , "Bicicletta" , "Verde" , "oicycle, jpg* ) ; 
Jveh3 = new automobile' 1 7, "Benzina" , 147, "Automobile" , "Rosso" , "car. )pg" J ; 
SveM » nei» autoSportiva(2, 1B, "Benzina* , 289, 'Auto sportiva" , 'Giallo" , 
•sportsCar.jpg"); 

Svehicles ■ acray ($veh,Sven2,$ven3,$ven4) ; 
foreach (Svehicles as $vehicle)! 

Svetiicle >display3()j fi il problema si verifica quii 

ecno("</table>"); 

} 

La soluzione chiama in causa il polimorfismo Iche significa capacità di assumere 
inulte forme). Dovete creare classi ereditate, ciascuna delle quali contenga funzioni 
con lo slesso nome. Neil esempio, tutte le funzioni di visualizzazione devono chia- 
nursi display ( ). come mostrato nella Figura 38.10. Qui tutte le classi nella struttu- 
ra di ereditarietà hanno una funzione chiamala display! ). Se lune le funzioni han- 
no lo stesso nome, si elimina il problema sollevalo in precedenza, in quanto potete 

$vehicl9->display(); 

Non ha Importanza a quale oggetto si faccia riferimento, in quante tutti hanno una 
funzione di visualizzazione con lo stesso nome. Questo, tuttavia, fa sorgere un nuo- 
vo problema Considerate la seguente funzione display! ) della classe autoSpor 
tiva: 

function display I) { 
$this->display(); 

echor < tr><td><font size e '2 ^Pressione turbo: </font></td> 

<td><font 5ize- , 2 , >' . 
$tnis >turbo . *</font></td>*/tr>'); 

} 

La funzione display! ) vuole chiamare la funzione display! ) de" 3 «-"lasse appena 
precedente nella struttura ili ereditarietà, in questo caso la classe automobile Ciò 
avviene con la seguente istruzione: 

$tnis->display(); 

Sfortunatamente questa istruzione non funzionerà, in quanto tenterà di chiamare la 
funzione display!) interna alla classe auto-Sportiva stessa. Occorre quindi un 
modo per specificare quale funzione display! ) chiamare. Questo e possibile con 
l operatore " : :'. Per esempio: 

automobile : '.display! ) ; 



chiamerà la finì/ione display!) della classe automobile 
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Figura 3B. 1 0 

Funzioni polimorfe. 

Correggendo lo script in modo che utilizzi l'operatore " : :" . otterrete il 
lo script seguente. 

<?php 

// Ereditarietà delle classi • Esempio 38 5 



class veicolo ( 
var Sdetcrtpuon; 
var Icolour; 
var tplo- 



function v«icoloi|d,»c,lp> [ 
Uhi* >4tac' i iu» • Mi 



} 



Ithis >colour - Se; 
Sthis >pic = Sp; 

I 

function display{) { 

echo( "<table bordar*'! >"); 

«cho( *«tr><td colspan- 2'><img src= 'graphics/ " . 

$this->pic . "><ltd><!Xr>")i 
echoC<tr>«td»<font size»' 2' iscrizione ;</fontx/td><tdxf ont 

lii««'2>' . Sthis ->oescription . '«c/fontxftdx/tr»' ) ; 
ecno( "<tr><td«font size=2 *Colore:</font></td><ta><font size=-2>' 

Sthis>colour . Wfontx/tdx/tr.'); 



class veicoloAMotore extends veicolo { 
var SfuelType; 
var $bhp; 

function veicoloAMotorelSft.Sb.Sd.Sc.Sp) { 



} 



$this >fuelType ■ $ft; 
Sthis ->bhp = $b; 
j Sthis ^veicolotSd.sc.Sp); 

function display!) ( 
veicolo: :display( ) ; 

echo( '«trxtdxfont 6iZ9=' 2 >Tipo di carburante :</font></td> 

<td><font size='2>" . Sthis >fuelType . ■</fontx/tdx/tr> 1 ) 

echo(*<tr><tdxfont sir«''2>Poten2a:</font><ytd><td>«font 
size= 2>" . $this->bhp . *<,fontx/tdx/tr>-); 

> 



class veicoloSenzaMotore extends veicolo { 
var SpowerSource; 

function veicoloSenzaMotore{Sps,Sd,$c,Sp) { 
Sthis ->powerSource = Sps; 
Sthis->veicolo<Sd,Sc,$p); 

function display () { 
veicolo: : display ( ) ; 



echo('<tr><td><fùnt size= - 2 ' Propulsione : </font></td><td><f ont 
8ize="2'>" . Sthis->powerSource . "</fontx/tdx/tr>" ) ; 



class bicicletta extenos veicoloSenzaMotore { 
var SframeSize; 
var Sgears; 

function blciCletta(Sps,$fs,Sg,$d,$c,$p) { 
*thi» >fr»iiwSiZi - $fs; 
Stnis >geart - Sg, 

St n 1 I >vtloo lo8#nf «Motor» (Sps, Sd , $c , Sp) ; 



- 



f 



) 

function display () { 

veicoloSenzaMotore: ;display() ; 

echo("<tr><td><font size- 2' dimensione telaio :</font></td><td><f ont 
size«'2">" . $this->franeSi2a . "</font></td></tr>"J; 

echo{ - <tr><td><:font size= '2' rapporti :</fontx/td><tdxf ont 
size='2 >" . Sthis ->gears . ■</fontx/td></tr>'); 



class aotoscafo extends veicoloAMotore { 
var SengìneType; 

function ■otoscafa($et,$ft,$b,$d,$c,Sp) { 
Sthis ->engineType ■ Set; 
$thia ->veicoloAMotore (Sf t , $b, Sd, Se , Spi ; 

> 

function display i j { 

veicoloAMotore: : display ( ) ; 

*choC<trxtdxfont size«'2' >Motore:</fontx/td><tdxf ont size«'2>". 
Sthis >engineType . Wfont></td»</tr»' ) ; 

J 

I 

class automobile extends veicoloAMotore { 
var SwheelSize; 

function automobilefSws.Sft.Sb.Sd.Sc.SpI { 
Sthis >wheelSize = Sws; 
Sthis- >veicoloAMotore(Sf t ,Sb F $d , Se ,Sp> ; 

} 

function display () { 

veicoloAMotore : : display ( ) ; 

ecnoc<tr><to><font size=' 2 ^Dimensione ruote :</fontx/td> 
<td><font 9ize='2 >* . Stbis >wheelSize . ■</fontx/M></tr>"|; 

} 

) 

class autosportiva extends automobile ( 
var Sturbo; 

function autosport iva { $t, Sws.Sft ,Sb,Sd, Se ,Sp) { 
Sthis ->turbo = St; 

Sthis - automobile (Sws.Sft.Sb.Sd, Se ,$p); 

> 

function display!) { 
automobile: : display ( ) ; 

echor < tr><td><font alzi" 'S - Pressione turbo :</font></td> 

<ta>ifoni HM-'I'»' . •tbis nurbo . ■</font>«/tdx/tr>")! 

I 



Sveh - n*w s»t 

M . jpg- 



'Qlallo" 



•v*h2 ■ new bicicletta! -Uaar.a- , 18, 21 , "Biciclitta- , "Verde* , "Bicycie. jpg" | ; 
$veh3 = new autowbilei 17, 'Benzina" , 1*7. 'Automooilt' , -Rotto" , "car . jpg,* ) j 
$veh4 = new auto$portiva(2 f 18, "Benzina" ,289, "Auto sportiva', 

•Giallo", "sportsCar.jpg-) ; 
Svehicles ■ array ($tfeh,$veh2,$vah3 J SvBh4); 
foreach (Svehìcies as $vehicle){ 

Svahicle ->display( ) ; 

echor</table>'); 

) 

?» 

L'output di questo script è quello della Figura 38.11. Coxite potete vedere, le funzioni 
jioliiiiorfe consentono di visualizzare quattri) diversi oggetti contenuti nell'array 




Figura3B.il 

Output polimorfe 




Questo capitolo ha introdotto il concetto di ereditarietà delle classi, mostrando 
come questa hanzionalità possa essere utilizzata per creare nuove classi basate su 
classi già esistenti, ti stato inoltre introdotto il concetto di polimorfismo, spiega n do 
come possa aiutare a manipolare e utilizzare le classi in una struttura di ereditarietà. 
Nel prossimo capitolo verrà preso in esame il ruolo dei commercio elettronico e si 
vedrà come sia possibile utilizzare PHP per creare un'applicazione Web di e-com- 
merce. 



